Skills for Claude Code
Claude Code skills for local issue tracking with beads, git worktree management, and prompt recording.
Installation
# Add the marketplace
/plugin marketplace add https://github.com/sttts/skills.git
# Install plugins
/plugin install sttts-beads
/plugin install sttts-worktree
/plugin install sttts-prompt-recording
Plugins
sttts-beads
Local issue tracking workflow integration using the beads CLI.
Triggers on: bd, beads, what's next, add task, add epic, or issue tracking questions
Requires: .beads directory in project root (run bd init to create)
Features
- Session priming - Run
bd prime at session start for AI-optimized context
- Task discovery - Ask "What's next?" to see in-progress and ready tasks
- Issue creation - Create tasks and epics with structured IDs
- State management - Track task status and link to PRs/MRs
- Session completion - Structured workflow for landing work safely
Issue ID Convention
Use the pattern <prefix>-<epic>-<task>:
prefix: domain area (e.g., infra, api, ui)epic: one or two keywords for the epictask: one keyword for the specific task
# Create a task
bd create "Allow blueprints to run in plan only mode" --id infra-blueprint-planonly --type task
# Create an epic
bd create "Expose Terraform errors to conditions" --id infra-tferrors --type epic
# Create a task under an epic
bd create "Phase 1: Enable log subresource" --id infra-tferrors-logsub --type task --parent infra-tferrors
Session Completion Workflow
When ending a session, the skill ensures:
- File issues for remaining work
- Run quality gates (tests, linters, builds)
- Update issue status
- Push to remote (mandatory - work is not complete until pushed)
- Label tasks with PR/MR URLs
- Add handoff comments for the next agent
sttts-worktree
Git worktree management with three skills:
/sttts-worktree:worktree (auto-triggered)
Git worktree commands and usage reference.
Triggers on: worktree, worktrees, create worktree, git worktree
/sttts-worktree:worktree-workflow (explicit only)
Opinionated workflow using .git/checkouts/ convention. Must be loaded explicitly.
- Create worktrees inside
.git/checkouts/
- Stay in the worktree - don't cd back to main
- Never touch main when working in a worktree
- Never delete before confirming merge
Enable per-repo:
git config --local claude.worktrees true
/sttts-worktree:prune-worktrees (auto-triggered)
Clean up worktrees whose branches have been merged. Works with both GitLab (glab) and GitHub (gh).
Triggers on: prune worktrees, cleanup worktrees, remove merged worktrees
- Detects GitLab or GitHub from remote URL
- Checks each worktree branch for merged MR/PR
- Shows dirty/merged/unmerged status
- Asks for confirmation before removing
sttts-prompt-recording
Record cleaned-up prompts attached to commits (via git notes) and MR/PR descriptions.
Triggers on: record prompt, prompt recording, log prompts
Features
- Git notes (
refs/notes/prompts) - Per-commit prompt history in structured JSON
- MR/PR description - High-level "Prompt Documentation" section summarizing the whole conversation
- Sticky opt-in - Enable per-repo with
git config --local claude.promptRecording true
- Dual platform - Works with both GitLab (
glab) and GitHub (gh)
Prompt Philosophy
- Record what the user actually asked for, not what the agent decided
- Write prompts as actionable instructions that could reproduce the result
- Capture architecture constraints and rejections - these explain WHY
- Add context lines after each prompt explaining what it changed
Enable per-repo
git config --local claude.promptRecording true
Usage Examples
# Start a session
bd prime
# Check what to work on
What's next?
# Create a new task
Add task: Implement user authentication
# Create a worktree for an epic
Create a worktree for the auth-refactor epic
# Clean up merged worktrees
/prune-worktrees
# Enable prompt recording
/prompt-recording
# End a session
Land the plane
Requirements
- beads CLI installed and configured (for sttts-beads)
glab or gh CLI installed (for sttts-worktree prune)- Git repository
License
MIT
sttts
sttts