How do I install the Tk skill?

Run npx skillmds@latest add tomevault-io/tk in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Tk skill do?

Git-backed ticket management for AI agents Use when this capability is needed. It is listed under Coding & Dev Tools on SkillMD.

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tk?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tk by tomevault-io — Agent Skill

Name: Tk
Author: tomevault-io

File contents

tk - Ticket Management

A minimal CLI for tracking tickets as markdown files in .tickets/.

Workflow

tk ready              # 1. Find available work
tk start <id>         # 2. Claim a ticket
tk show <id>          # 3. Read details
# ... do the work
tk close <id>         # 4. Mark complete

Core Commands

Command	Description
`tk create "title"`	Create ticket (returns ID)
`tk show <id>`	View ticket details
`tk start <id>`	Claim ticket (set to in_progress)
`tk close <id>`	Complete ticket
`tk reopen <id>`	Revert to open
`tk edit <id>`	Open in $EDITOR

Listing & Filtering

tk list                      # All tickets
tk list --status open        # By status (open|in_progress|closed)
tk list -a alice             # By assignee
tk list -T urgent            # By tag
tk ready                     # Open tickets with resolved deps
tk blocked                   # Tickets with unresolved deps
tk closed                    # Recently closed

Create Options

tk create "Fix login bug" \
  -d "Description text" \
  -t bug \                   # Type: bug|feature|task|epic|chore
  -p 1 \                     # Priority: 0-4 (0=highest)
  -a alice \                 # Assignee
  --parent <epic-id> \       # Parent ticket
  --tags ui,urgent           # Tags

Dependencies

tk dep add <id> <depends-on>   # Add dependency
tk dep remove <id> <dep-id>    # Remove dependency
tk dep tree                    # Show dependency tree
tk dep check                   # Check for cycles

Notes & Links

tk add-note <id> "Progress update"   # Add timestamped note
tk link <id1> <id2>                  # Link related tickets
tk unlink <id1> <id2>                # Remove link

Export

tk query                    # JSON output
tk query '.[] | .title'     # With jq filter

Tips

Partial ID matching: tk show a1b matches tic-a1b2c3
Tickets stored in .tickets/ as markdown with YAML frontmatter
Git-friendly: commit tickets with your code

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: tkdescription: Git-backed ticket management for AI agents Use when this capability is needed.---# tk - Ticket ManagementA minimal CLI for tracking tickets as markdown files in `.tickets/`.## Workflow```bashtk ready # 1. Find available worktk start <id> # 2. Claim a tickettk show <id> # 3. Read details# ... do the worktk close <id> # 4. Mark complete```## Core Commands| Command | Description ||---------|-------------|| `tk create "title"` | Create ticket (returns ID) || `tk show <id>` | View ticket details || `tk start <id>` | Claim ticket (set to in_progress) || `tk close <id>` | Complete ticket || `tk reopen <id>` | Revert to open || `tk edit <id>` | Open in $EDITOR |## Listing & Filtering```bashtk list # All ticketstk list --status open # By status (open|in_progress|closed)tk list -a alice # By assigneetk list -T urgent # By tagtk ready # Open tickets with resolved depstk blocked # Tickets with unresolved depstk closed # Recently closed```## Create Options```bashtk create "Fix login bug" \ -d "Description text" \ -t bug \ # Type: bug|feature|task|epic|chore -p 1 \ # Priority: 0-4 (0=highest) -a alice \ # Assignee --parent <epic-id> \ # Parent ticket --tags ui,urgent # Tags```## Dependencies```bashtk dep add <id> <depends-on> # Add dependencytk dep remove <id> <dep-id> # Remove dependencytk dep tree # Show dependency treetk dep check # Check for cycles```## Notes & Links```bashtk add-note <id> "Progress update" # Add timestamped notetk link <id1> <id2> # Link related ticketstk unlink <id1> <id2> # Remove link```## Export```bashtk query # JSON outputtk query '.[] | .title' # With jq filter```## Tips- Partial ID matching: `tk show a1b` matches `tic-a1b2c3`- Tickets stored in `.tickets/` as markdown with YAML frontmatter- Git-friendly: commit tickets with your code---> Converted and distributed by [TomeVault](https://tomevault.io/claim/radutopala) — claim your Tome and manage your conversions.

Frequently asked questions

Tk