design-qa

Claude Code Skills & Components

Reusable components for Claude Code: skills, agents, commands, and more. Built for token efficiency, cross-model compatibility, and minimal friction.

Components

Component	Type	Version	What it does
linear	Skill	0.5.1	Linear project management with session continuity. Buffered writes, board management, ticket creation, structured handoffs persisted to Linear. Auto-maintains .latest-status.md.
handoff	Skill	3.0.1	Session continuity via .latest-status.md. Auto-updates during plan execution. Manual handoff, resume, and transfer commands.
vault-backup	Skill	1.0	Save research, project outputs, and knowledge artifacts from any Claude Code workspace into a shared Obsidian knowledge vault.
ai-router	Skill	1.1	Route tasks to optimal model tiers and ensemble responses across Claude, GPT, and Gemini APIs. Requires curl and jq.
pull-and-sync	Command	1.0	Sync working branch with latest from default branch using merge --no-ff.
commit	Command	1.0	Smart commit with conventional format, staged diffs, and hook compliance.
push	Command	1.0	Push with safety checks, branch protection, and tracking setup.
commit-push-pr	Command	1.0	Full pipeline: commit, push, and create a PR via gh CLI.
update-skills	Command	1.0	Check installed Stacklist components for available updates.

Install

Copy a component to your Claude Code config directory:

# Install a skill
cp -r .claude/skills/linear/ ~/.claude/skills/linear/

# Install an agent
cp .claude/agents/<name>.md ~/.claude/agents/

# Install a command
cp .claude/commands/commit.md ~/.claude/commands/

Then reference skills in your project's CLAUDE.md:

## Skills
Load skills from ~/.claude/skills/ as needed.

Check for Updates

Each component has a version in its frontmatter. Compare against versions.yaml in this repo:

curl -s https://raw.githubusercontent.com/stacklist/claude-code-skills/main/versions.yaml

Or check locally if you've cloned the repo:

cat versions.yaml

Repo Structure

claude-code-skills/
├── README.md
├── CLAUDE.md
├── versions.yaml
└── .claude/
    ├── skills/
    │   ├── linear/
    │   │   ├── SKILL.md
    │   │   └── REFERENCE.md
    │   ├── handoff/
    │   │   └── SKILL.md
    │   ├── vault-backup/
    │   │   └── SKILL.md
    │   ├── ai-router/
    │   │   ├── SKILL.md
    │   │   └── REFERENCE.md
    ├── agents/
    │   └── .gitkeep
    └── commands/
        ├── commit.md
        ├── push.md
        ├── commit-push-pr.md
        ├── pull-and-sync.md
        ├── update-skills.md
        └── vault-backup.md

Design Principles

These components are built around a few constraints that shape every decision.

Token efficiency is a first-class concern. Every instruction competes for context window space. Templates and formats are as lean as possible without sacrificing clarity. If removing a line wouldn't cause the LLM to make a mistake, the line gets cut.

Cross-model compatibility. Components use standard markdown with YAML frontmatter. No model-specific syntax or features. They should work in Claude Code, Cursor, Windsurf, or any tool that reads markdown skill files.

Progressive disclosure. Not everything loads at once. Reference files are loaded on demand. The agent gets what it needs for the current command, not the entire knowledge base.

Upgrade Notes

Linear v0.5.1 / Handoff v3.0.1

Fixes a frontmatter parsing bug in both skills. The ## Version Check section was placed before the YAML frontmatter, preventing the parser from reading trigger, description, and other metadata. This caused /linear update to run a version check instead of posting a project status update, and both skills to appear as "Version Check" in the skill list.

To upgrade:

cp -r .claude/skills/linear/ ~/.claude/skills/linear/
cp -r .claude/skills/handoff/ ~/.claude/skills/handoff/

Linear v0.5.0

The linear skill now auto-maintains .latest-status.md (the same file used by the handoff skill), eliminating the need to run /handoff separately when using Linear.