@php-workx/skill-tk
v0.1.0
Published
Git-native ticket tracking skill for Claude Code and Codex. Plain markdown tickets with YAML frontmatter, dependency graphs, and plugin system.
Downloads
57
Maintainers
Readme
tk
Git-native ticket tracking skill for Claude Code and Codex. Track issues as plain markdown files alongside your code — no databases, no daemons, just files in .tickets/.
Why Use This?
- Plain markdown: Tickets are markdown files with YAML frontmatter, directly readable by AI agents without JSON parsing
- Git-native: Tickets live alongside code, tracked by git, survive compaction and session boundaries
- Dependency graphs: Track blockers with cycle detection;
tk readyshows only unblocked work - IDE-friendly: Ticket IDs double as filenames — Ctrl+Click on
nw-5c46in git log opens the ticket - Plugin-extensible: Drop
tk-<cmd>executables in PATH to extend functionality
Quick Start
tk ready # what's unblocked and ready to work on
tk create "Fix login bug" -t bug -p 1
tk show mp-a3x9 # full ticket with computed context
tk start mp-a3x9 # mark as in progress
tk close mp-a3x9 # doneInstall
Prerequisites: ticket CLI installed (brew install ticket).
# Via installer script
git clone --depth 1 https://github.com/php-workx/skill-tk.git
cd skill-tk && bash scripts/install-tk-skill.sh
# Via OpenSkills
npx openskills install php-workx/skill-tkAfter install, restart Claude/Codex so the new skill is loaded.
What It Does
The skill teaches Claude/Codex how to use tk for persistent issue tracking:
- Session start:
tk readyshows actionable work - During work: Create, update, and close tickets as context changes
- Session end: Ticket notes preserve state across sessions
- After compaction: Tickets survive — they're files in git, not conversation memory
Documentation
| Document | Purpose |
|----------|---------|
| CLI_REFERENCE.md | All commands, flags, environment variables |
| TICKET_CREATION.md | When/how to create tickets, file format |
| DEPENDENCIES.md | Dependencies, links, parent-child hierarchy |
| WORKFLOWS.md | Session start, epic planning, checklists |
| PATTERNS.md | Knowledge work, resume, side quests |
| INTEGRATION_PATTERNS.md | Task tools layering, RPI workflow |
| PLUGIN_SYSTEM.md | Using and creating plugins |
| ANTI_PATTERNS.md | Common mistakes and how to avoid them |
| TROUBLESHOOTING.md | Fixing common issues |
Development
bash scripts/validate.sh # validate skill structure
just check # full local quality gateLicense
See LICENSE.
