Skills Reference

Skills Reference¶

Skills are slash commands that run inside your AI assistant (e.g., /ctx-next), as opposed to CLI commands that run in your terminal (e.g., ctx status).

Skills give your agent structured workflows: It knows what to read, what to run, and when to ask. Most wrap one or more ctx CLI commands with opinionated behavior on top.

All Skills¶

Session Lifecycle¶

Skills for starting, running, and ending a productive session.

/ctx-remember¶

Recall project context and present a structured readback.

Wraps: ctx agent --budget 4000, ctx recall list --limit 3, reads TASKS.md, DECISIONS.md, LEARNINGS.md

See also: The Complete Session

/ctx-status¶

Show context summary — files, token budget, tasks, recent activity — with interpreted suggestions.

Wraps: ctx status [--verbose] [--json]

See also: The Complete Session, ctx status CLI

/ctx-agent¶

Load the full context packet optimized for AI consumption. Also runs automatically via the PreToolUse hook with cooldown.

Wraps: ctx agent [--budget] [--format] [--cooldown] [--session]

See also: The Complete Session, ctx agent CLI

/ctx-next¶

Suggest 1-3 concrete next actions ranked by priority, momentum, and unblocked status.

Wraps: reads TASKS.md, ctx recall list --limit 3

See also: The Complete Session, Tracking Work Across Sessions

/ctx-commit¶

Commit code with integrated context persistence — pre-commit checks, staged files, Co-Authored-By trailer, and a post-commit prompt to capture decisions and learnings.

Wraps: git add, git commit, optionally chains to /ctx-add-decision and /ctx-add-learning

See also: The Complete Session

/ctx-reflect¶

Pause and reflect on session progress. Walks through a checklist of learnings, decisions, task completions, and session notes to persist.

Wraps: chains to ctx add learning, ctx add decision, manual TASKS.md updates

See also: The Complete Session, Persisting Decisions, Learnings, and Conventions

Context Persistence¶

Skills for recording work artifacts — tasks, decisions, learnings, conventions — into .context/ files.

/ctx-add-task¶

Add an actionable task with optional priority and phase section.

Wraps: ctx add task "description" [--priority high|medium|low]

See also: Tracking Work Across Sessions

/ctx-add-decision¶

Record an architectural decision with context, rationale, and consequences. Supports Y-statement (lightweight) and full ADR formats.

Wraps: ctx add decision "title" --context "..." --rationale "..." --consequences "..."

See also: Persisting Decisions, Learnings, and Conventions

/ctx-add-learning¶

Record a project-specific gotcha, bug, or unexpected behavior. Filters for insights that are searchable, project-specific, and required real effort to discover.

Wraps: ctx add learning "title" --context "..." --lesson "..." --application "..."

See also: Persisting Decisions, Learnings, and Conventions

/ctx-add-convention¶

Record a coding convention that should be standardized across sessions. Targets patterns seen 2-3+ times.

Wraps: ctx add convention "rule" --section "Name"

See also: Persisting Decisions, Learnings, and Conventions

/ctx-archive¶

Archive completed tasks from TASKS.md to a timestamped file in .context/archive/. Preserves phase headers for traceability.

Wraps: ctx tasks archive [--dry-run]

See also: Tracking Work Across Sessions

Scratchpad¶

/ctx-pad¶

Manage the encrypted scratchpad — add, remove, edit, and reorder one-liner notes. Encrypted at rest with AES-256-GCM.

Wraps: ctx pad, ctx pad add, ctx pad rm, ctx pad edit, ctx pad mv

See also: Scratchpad, Using the Scratchpad with Claude

Journal & History¶

Skills for browsing, exporting, and enriching your AI session history into a structured journal.

/ctx-recall¶

Browse, inspect, and export AI session history. List recent sessions, show details by slug or ID, and export to .context/journal/.

Wraps: ctx recall list, ctx recall show, ctx recall export

See also: Browsing and Enriching Past Sessions

/ctx-journal-enrich¶

Enrich a single journal entry with YAML frontmatter — title, type, outcome, topics, technologies, and summary. Shows diff before writing.

Wraps: reads and edits .context/journal/*.md files

See also: Browsing and Enriching Past Sessions, Turning Activity into Content

/ctx-journal-enrich-all¶

Batch-enrich all unenriched journal entries. Filters out short sessions and continuations. Can spawn subagents for large backlogs.

Wraps: iterates /ctx-journal-enrich across all entries

See also: Browsing and Enriching Past Sessions

/ctx-journal-normalize¶

Normalize journal markdown for clean rendering — fix fence nesting, metadata formatting, list indentation, and collapse large tool outputs.

Wraps: reads and edits .context/journal/*.md files

See also: Browsing and Enriching Past Sessions, Turning Activity into Content

Content Creation¶

Skills for turning project activity into publishable content.

/ctx-blog¶

Generate a blog post draft from recent project activity — git history, decisions, learnings, tasks, and journal entries. Requires a narrative arc (problem, approach, outcome).

Wraps: reads git log, DECISIONS.md, LEARNINGS.md, TASKS.md, journal entries; writes to docs/blog/

See also: Turning Activity into Content

/ctx-blog-changelog¶

Generate a themed blog post from a commit range. Takes a starting commit and unifying theme, analyzes diffs and journal entries from that period.

Wraps: git log, git diff --stat; writes to docs/blog/

See also: Turning Activity into Content

Auditing & Health¶

Skills for detecting drift, auditing alignment, and improving prompt quality.

/ctx-drift¶

Detect and fix context drift: stale paths, missing files, file age staleness, task accumulation, and constitution violations via ctx drift. Also detects skill drift against canonical templates.

Wraps: ctx drift [--fix]

See also: Detecting and Fixing Drift

/ctx-alignment-audit¶

Audit behavioral claims in docs and recipes against actual agent instructions. Traces each claim to its backing instruction and reports coverage as Covered, Partial, or Gap.

Wraps: reads AGENT_PLAYBOOK.md, .claude/skills/, CLAUDE.md, and docs/recipes

See also: Detecting and Fixing Drift

/ctx-prompt-audit¶

Analyze recent prompting patterns to identify vague or ineffective prompts. Reviews 3-5 journal entries and suggests rewrites with positive observations.

Wraps: reads .context/journal/ entries

See also: Detecting and Fixing Drift

/check-links¶

Scan all markdown files under docs/ for broken links. Two passes: internal links (verify file targets exist on disk) and external links (HTTP HEAD with timeout, report failures as warnings). Also checks image references.

Invoked automatically as check #12 during /consolidate.

Wraps: Glob + Grep to scan, curl for external checks

See also: /consolidate

/ctx-context-monitor¶

Respond to context checkpoint signals when usage hits high thresholds. Fires at adaptive intervals and offers context persistence before the session ends.

Type: Automatic: Triggered by the check-context-size hook, not user-invocable

Wraps: hook-driven; suggests /ctx-reflect

See also: Running an Unattended AI Agent

Planning & Execution¶

Skills for structured implementation and parallel agent workflows.

/ctx-implement¶

Execute a multi-step plan with build and test verification at each step. Loads a plan from a file or conversation context, breaks it into atomic steps, and checkpoints after every 3-5 steps.

Wraps: reads plan file, runs verification commands (go build, go test, etc.)

See also: Running an Unattended AI Agent

/ctx-loop¶

Generate a ready-to-run shell script for autonomous AI iteration. Supports Claude Code, Aider, and generic tool templates with configurable completion signals.

Wraps: ctx loop [--tool] [--prompt] [--max-iterations] [--completion] [--output]

See also: Autonomous Loops, Running an Unattended AI Agent

/ctx-worktree¶

Manage git worktrees for parallel agent development. Create sibling worktrees on dedicated branches, analyze task blast radius for grouping, and tear down with merge.

Wraps: git worktree add, git worktree list, git worktree remove, git merge

See also: Parallel Agent Development with Git Worktrees

Project-Specific Skills¶

The ctx plugin ships the skills listed above. Teams can add their own project-specific skills to .claude/skills/

Project-specific skills follow the same format and are invoked the same way.

Custom skills are not covered in this reference.