agentsclimarketplace

Md tasks

Skill Unique-Divine/jiyuu/ai-skills/md-tasks

Apply consistent Markdown checkbox task conventions in READMEs, epics/journals, specs, and design docs. Use when the user wants task lists with "- [ ]" / "- [x]", nested subtasks, context sub-bullets under items, or terminal commands (grep/rg) to list open versus completed tasks in Markdown files — especially in repo documentation and planning Markdown.From its SKILL.md

Install
npx -y skills add Unique-Divine/jiyuu --skill md-tasks

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
  • runs commandsInstructs the agent to run 4 commands, including `grep -rF -- '- [x]' <path-or-glob>` and 3 more.

SKILL.md

2.7 KB, 573 tokens by cl100k_base, as published. Nobody here has run it

Markdown tasks and checkbox conventions

Follow these conventions so agents and humans can scan open work reliably.

Usage guidelines

Checkbox notation

Denote open tasks or TODOs with standard checkbox notation:

  • - [ ] for incomplete tasks.
  • - [x] for done tasks.

Indentation defines subtasks: extra leading spaces nest bullets under a parent item.

In planning/spec documents, default every actionable item at every nesting level to checkbox notation. Do not hide implementation work in ordinary bullets.

Often add ordinary sub-bullets for status or context beneath a task, but only when the bullet is not itself work to do. For example:

- [ ] Some task
  - Status: maybe some status description or how it was completed
  - More context
  - [ ] Subtask A

This keeps review tight: unfinished work sorts visually to checklist lines while still allowing narrative detail.

Actionable sub-bullets

If a sub-bullet describes work to do, a decision to resolve, behavior to implement, a file to create, a test to add, or an acceptance criterion to verify, write it as a checkbox task too:

- [ ] Implement tx archive CLI.
  - [ ] Keep Bash responsible for chain config, keyring preflight, and broadcast.
  - [ ] Make TypeScript responsible for txhash parsing and Markdown formatting.
  - Rationale: TypeScript is easier to test for JSON, filenames, and CLI args.

Use ordinary nested bullets only for non-actionable context, rationale, status, examples, or notes. When unsure whether a sub-bullet is actionable, prefer - [ ].

Task Questions

Sometimes we'll pose a question or frame a resolve decision as a task. That can look like this.

- [ ] Q: Some open question?
  A: An answer on what to do. The question task is complete when each of the
  potential subtasks is completed or the answer, "A: ..." is implemented.

Finding tasks in the terminal

Patterns differ by shell (**/*.md is not universal glob). Typical approaches:

# Completed tasks under a directory (GNU grep fallback)
grep -rF -- '- [x]' <path-or-glob>

# Open tasks — limit to Markdown (example: cwd tree)
grep -rF -- '- [ ]' . --include='*.md'

Or use rg for ** globs and filters:

rg --fixed-strings -g '*.md' -- '- [ ]'
rg --fixed-strings -g '*.md' -- '- [x]'

Tune paths and -g/globbing to match the repo layout.

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 611,919. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.