Agent skill
tasuku
Agent-first task management. Use when tracking multi-session work, recording learnings/decisions, managing task dependencies, or persisting context across sessions. Provides tk_list, tk_add, tk_done, tk_start, tk_learn, tk_decide, tk_note, tk_show, tk_find, tk_ready, tk_context, tk_stats, tk_block, tk_task, tk_metadata, tk_manage, tk_health, tk_suggest, tk_deps, and tk_help tools.
Install this agent skill to your Project
npx add-skill https://github.com/iheanyi/tasuku/tree/main/.agents/skills/tasuku
SKILL.md
Tasuku — Agent-First Task Management
Tasuku provides persistent, git-friendly task management designed for AI agents working on codebases.
When to Use Tasuku
- Multi-session work: Tasks, learnings, and decisions persist across sessions
- Task dependencies: Block/unblock tasks, track what's ready to work on
- Knowledge capture: Record learnings ("Never X", "Always Y") and architectural decisions
- Project context: Get a summary of project state at any time
Quick Start
Check project state
Use tk_context to get a full overview of tasks, learnings, and decisions.
Pick up work
Use tk_ready to see tasks ready to work on, then tk_start to begin.
Track progress
tk_add— Create new taskstk_note— Add progress notes to taskstk_done— Mark tasks complete
Capture knowledge
tk_learn— Record insights, gotchas, rules ("Never manually edit ANSI strings")tk_decide— Record architectural decisions with alternatives and reasoning
Task vs Session Scope
Use Tasuku for project-level work that spans sessions:
- Features, bugs, milestones
- Architectural decisions
- Cross-cutting learnings
Use your editor's built-in task list for session-level steps:
- Implementation steps within a single session
- Temporary checklists
Workflow Commands
Starting a Session
tk_context— See project overviewtk_ready— Find next task to work ontk_start— Begin working on a task
During Work
tk_note— Record progress, blockers, or findingstk_learn— Capture insights as you discover themtk_block— Mark tasks blocked by other tasks
Completing Work
tk_done— Mark task completetk_learn— Capture what you learned (don't skip this!)tk_ready— See what's unblocked and ready next
Finding Information
tk_find— Search across tasks, learnings, and decisionstk_show— Get full details on a specific tasktk_deps— See task dependency graphtk_stats— Project health metrics
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mattpocock/skills
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
mattpocock/skills
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
mattpocock/skills
migrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
mattpocock/skills
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
mattpocock/skills
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?