claude-code-primitives

SkillProductivity

Reference for Claude Code's own mechanics — slash commands, skills, subagents, hooks — and how they route together. Use when creating or editing a slash command, skill, subagent, or hook, or when deciding which primitive fits a task.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the claude-code-primitives skill

What this skill tells your AI

The instructions your AI receives, as published by vscarpenter/gsd-task-manager in .claude/skills/claude-code-primitives/SKILL.md and read by ahel’s review.

Claude Code Primitives

  • Routing: Commands initiate, subagents verify, hooks gate.
  • Slash Commands (.claude/commands/): Short, repeatable actions. Canonical text of prompts lives here (e.g., /qspec, /tdd, /qcheck).
  • Skills (.claude/skills/): Complex multi-step workflows. Write descriptions as triggers ("when should I fire?"). Provide goals, constraints, and a "Gotchas" section.
  • Subagents (.claude/agents/): Spawn for fanning out or parallel reads. Skip for <3 tool calls. Read-only agents use haiku; write agents use sonnet/opus with isolation: worktree.
  • Agent teams vs subagents: Use subagents for scoped delegation inside one workstream. Use teams when work should split across longer-lived sessions that coordinate.
  • Hooks: Enforce standards mechanically (e.g., PostToolUse, Stop). Hook types: shell commands, prompt hooks, MCP tool hooks.
  • Hooks receive event data as JSON on stdin. Read fields with jq, for example .tool_input.file_path; do not rely on $CLAUDE_FILE_PATH style variables unless explicitly configured.

Signals

GitHub stars
25
Forks
3
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
claude-code-primitives
Source
github.com/vscarpenter/gsd-task-manager