# Yarstack Create Todo

> Create a committed Markdown todo in ~/.create-todo from a todo, task, follow-up, $create-todo request, or current conversation context.

- **Type:** Skill
- **Install:** `agentstack add skill-yarlson-yarstack-yarstack-create-todo`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [yarlson](https://agentstack.voostack.com/s/yarlson)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [yarlson](https://github.com/yarlson)
- **Source:** https://github.com/yarlson/yarstack/tree/main/yarstack-create-todo

## Install

```sh
agentstack add skill-yarlson-yarstack-yarstack-create-todo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Create Todo

Create one durable Markdown todo from the user's request and current conversation context.

## Rules

- Do not read local project files unless the user explicitly references them.
- The todo must have a concrete action and clear acceptance criteria. If either is missing or vague, ask targeted clarification questions using the available question/user-input tool. If no such tool is available, ask directly. Ask as many times as needed before creating the todo.
- Synthesize a concise human title from the request and context. Do not use the user's raw wording if a clearer title is available.
- Write minimal Markdown: `# Title`, then a concise freeform body.
- If the bundled script returns a source repo URL, include it as the first body line: `Source: https://github.com/owner/repo`.
- Keep the body freeform, but make the action and acceptance criteria explicit.

## Workflow

1. Confirm the action and acceptance criteria are clear.
2. Generate the todo title and body.
3. Capture the user's current working directory, then run the bundled script from this skill directory with that source directory:

   ```bash
   source_dir="$PWD"
   skill_dir=""
   "$skill_dir/create-todo.sh" --cwd "$source_dir" ""
   ```

   The script prints two lines:
   - line 1: absolute path to the empty todo file
   - line 2: optional GitHub source repo URL; empty when unavailable

4. Write the Markdown content to the returned file path.
5. Format the todo:

   ```bash
   bunx prettier --write "$todo_file"
   ```

   If `bunx` is unavailable, use:

   ```bash
   npx prettier --write "$todo_file"
   ```

   If formatting fails, stop before committing.

6. Commit only the new todo file in `~/.create-todo`:

   ```bash
   todo_root="$HOME/.create-todo"
   todo_rel="${todo_file#"$todo_root"/}"
   git -C "$todo_root" add -- "$todo_rel"
   git -C "$todo_root" commit -m "todo: " -- "$todo_rel"
   ```

   Do not stage or commit any other files. If the commit fails, surface git's error.

7. If `~/.create-todo` has an `origin` remote, push `main`:

   ```bash
   git -C "$HOME/.create-todo" push origin main
   ```

   If no `origin` exists, report that the todo was committed locally and push was skipped. If push fails, report that the todo was created and committed, then surface the push error.

## Script Contract

`create-todo.sh` owns deterministic file creation and first-run todo-store setup:

- creates `~/.create-todo`
- initializes git on `main` when needed
- creates and commits minimal `README.md` and `.gitignore` as `initialize todo store` when the todo store has no commits
- detects the source project from `--cwd` git `origin`, git root, or folder name
- creates `~/.create-todo//---.md`
- returns the todo file path and optional GitHub source repo URL

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [yarlson](https://github.com/yarlson)
- **Source:** [yarlson/yarstack](https://github.com/yarlson/yarstack)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-yarlson-yarstack-yarstack-create-todo
- Seller: https://agentstack.voostack.com/s/yarlson
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.