skill-issues: Instructions file for Claude Code

CLAUDE.md

Instructions for Claude Code when working with this repository.

Skills Included

This repo provides three Claude Code skills designed around protocol fitness - formats that LLMs know well from training data.

• issues - Local-first issue tracking with GitHub Issues semantics
• sessions - Capture learnings, open questions, and next actions across sessions
• adr - Architecture Decision Records using familiar RFC/PEP patterns

Each skill is self-documenting via its SKILL.md file. Invoke them naturally by describing what you want to do.

Example Data

This repo includes real data from building these skills:

• .issues/events.jsonl - Issues tracking the project
• .sessions/events.jsonl - Sessions of learnings
• decisions/ - Design decisions made along the way

Installation

Install the skill-issues package to get the CLI tools:

uv tool install skill-issues

This provides global issues and sessions commands that work in any project directory.

Features

Issues CLI:

• issues --open / issues --ready / issues --closed - Query issues
• issues create "Title" / issues close ID "Reason" - Manage issues
• issues note ID "Content" - Add notes to issues
• issues --diagram - Visualize dependencies
• issues board - Interactive Kanban TUI

Sessions CLI:

• sessions - Show last session
• sessions --last 3 / sessions --topic keyword - Query sessions
• sessions --create "topic" - Create session
• sessions board - Interactive TUI browser

Permissions

Add to your project's .claude/settings.json:

{
  "permissions": {
    "allow": [
      "Bash(issues:*)",
      "Bash(sessions:*)"
    ]
  }
}

Using Skills in Other Projects

Use issues init to set up skills in any project:

# In the target project directory
issues init --all           # Install all skills (issues, sessions, adr)
issues init                  # Install just issues skill
sessions init                # Install just sessions skill