Hack Tickets
Productivityhack-ticketsHack Tickets is an Agent Skill for productivity published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use the hack tickets extension (git-backed JSONL event log) to create/list/show/sync lightweight tickets. Trigger when asked to track work items, decisions, or bugs inside a repo without external issue trackers. Prefer `hack x tickets ...` commands; store lives on hidden ref `refs/hack/tickets` by default.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/development/hack-tickets/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/hack-tickets, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
hack tickets
This repo uses the hack tickets extension (dance.hack.tickets).
Enable
Enable globally:
hack config set --global 'controlPlane.extensions["dance.hack.tickets"].enabled' true
Or per-project by adding .hack/hack.config.json:
{
"controlPlane": {
"extensions": {
"dance.hack.tickets": { "enabled": true }
}
}
}
Commands
- Create:
hack x tickets create --title "..." [--body "..."] [--body-file <path>] [--body-stdin] [--depends-on "..."] [--blocks "..."] [--actor "..."] [--json] - List:
hack x tickets list [--json] - Tui:
hack x tickets tui - Show:
hack x tickets show <ticket-id> [--json] - Update:
hack x tickets update <ticket-id> [--title "..."] [--body "..."] [--depends-on "..."] [--blocks "..."] [--clear-depends-on] [--clear-blocks] [--json] - Status:
hack x tickets status <ticket-id> <open|in_progress|blocked|done> [--json] - Sync:
hack x tickets sync [--json]
Recommended body template (Markdown):
## Context
## Goals
## Notes
## Links
Tip: use --body-stdin for multi-line markdown.
Data model
- Tickets are derived from an append-only event log (JSONL).
- Local state lives in
.hack/tickets/(gitignored on the main branch). - Sync writes commits to a dedicated ref (
refs/hack/ticketshidden by default) and pushes to your remote. - Set
controlPlane.tickets.git.refModetoheadsto use a normal branch ref (and protect it if desired).
Tips
- Keep ticket titles short; put detail in
--body. - Use
--jsonfor agent workflows and piping. - Run
hack x tickets syncbefore opening PRs if you want tickets to travel with the repo.