help

Installation
SKILL.md

<tool_restrictions>

MANDATORY Tool Restrictions

BANNED TOOLS — calling these is a skill violation:

  • EnterPlanMode — BANNED. This skill outputs information directly.
  • ExitPlanMode — BANNED. You are never in plan mode.
  • AskUserQuestion — BANNED. This is a read-only info dump, not interactive. </tool_restrictions>

/arc:help

Show every Arc command with context-aware relevance annotations.


Step 1: Gather Context (quick, parallel)

Run these checks in parallel. Keep it fast — no deep exploration.

# What framework/stack?
ls package.json next.config.* vite.config.* nuxt.config.* 2>/dev/null | head -5

# Arc artifacts?
ls docs/vision.md docs/arc/specs/*.md docs/arc/plans/*.md 2>/dev/null | head -10

# Design docs?
ls docs/design-context.md docs/arc/specs/design-*.md 2>/dev/null | head -5

# Test setup?
ls vitest.config.* jest.config.* playwright.config.* cypress.config.* 2>/dev/null | head -5

# Has UI? (React/Vue/Svelte components)
ls src/app/**/*.tsx app/**/*.tsx src/components/**/*.tsx components/**/*.tsx 2>/dev/null | head -3

# Has AI features?
grep -rl "from ['\"]ai['\"]" src/ app/ lib/ 2>/dev/null | head -3

# Git state
git log -1 --format=%ci 2>/dev/null
git diff --name-only HEAD~5 2>/dev/null | head -20

# CLAUDE.md or rules?
ls CLAUDE.md .claude/rules/**/*.md rules/**/*.md 2>/dev/null | head -5

# Progress journal?
head -20 docs/arc/progress.md 2>/dev/null

From these checks, build a mental model of what's present and what's missing.


Step 2: Output the Command Guide

Present all commands in a single output. Use the context to annotate relevance.

Format

For each command group, output:

## [Group Name]

| Command | What it does | Relevance |
|---------|-------------|-----------|
| `/arc:command` | One-line description | **Relevant** — [why] |
| `/arc:command` | One-line description | *Low relevance* — [why] |

Relevance rules:

  • Relevant — the project has the prerequisites AND there's a reason to use it now
  • Available — the project has the prerequisites but no urgent reason
  • Low relevance — project is missing prerequisites (e.g., no UI = no /arc:design)
  • Not applicable — fundamentally doesn't apply (e.g., no codebase at all)

The Catalog

Output ALL of these in order:


ENTRY POINTS

Command What it does When to use
/arc:go Understands your codebase, asks what you want to do, routes to the right workflow Starting a session, unsure where to begin
/arc:help This command — shows all commands with context When you want to see what's available

FOUNDATION

Command What it does When to use
/arc:vision Define project goals, purpose, and success criteria New projects, or when goals are unclear

DESIGN

Command What it does When to use
/arc:brand Create a visual identity system — palette, typography, tone, and generated assets New projects, rebranding, before design work
/arc:ideate Turn an idea into a validated design through collaborative dialogue New features that need thinking before building
/arc:design Create distinctive, non-generic UI with aesthetic direction and wireframes When building UI that should be memorable
/arc:naming Generate and validate project names with domain/GitHub checks Naming a new project or product

EXECUTE

Command What it does When to use
/arc:implement Scope-aware planning and execution with TDD Small fixes through substantial features
/arc:ai AI SDK guidance — correct patterns, deprecated API warnings Before implementing any AI feature

REVIEW

Command What it does When to use
/arc:review Expert review with parallel specialized agents (security, design, performance, etc.) Before merging, after implementation
/arc:audit Mechanical verification plus comprehensive audit Quick checks, focused audits, before shipping

TEST

Command What it does When to use
/arc:testing Test strategy and execution — unit, integration, E2E with specialist agents Creating test plans, running suites, fixing failures
SHIP
Command What it does When to use
/arc:letsgo Production readiness checklist Final gate before production deployment

CROSS-CUTTING

Command What it does When to use
/arc:responsive Audit and fix mobile responsiveness with visual verification After building desktop-first UI
/arc:seo Deep SEO audit — meta tags, structured data, crawlability Before launching public-facing pages
/arc:commit Smart commit with auto-splitting across domains When ready to commit changes
/arc:suggest What to work on next — analyzes codebase, issues, and debt Starting a session, unsure what to tackle
/arc:document Capture solved problems as searchable documentation After solving a non-obvious problem
/arc:tidy Clean up completed plans in docs/arc/plans/ When plan files accumulate
/arc:rules Apply Arc's coding rules to the project Setting up a new project with Arc conventions
/arc:deps Dependency audit — outdated packages, CVEs, batch upgrades Periodic maintenance, before shipping
/arc:hooks Install Claude Code hooks for auto-formatting, linting, context Setting up development environment

UTILITY

Command What it does When to use
/arc:prune-agents Kill orphaned Claude subagent processes When agents didn't exit cleanly

Step 3: Contextual Recommendations

After the catalog, add a short section:

## Recommended Right Now

Based on what I found in your project:

1. **[Command]** — [specific reason based on context]
2. **[Command]** — [specific reason based on context]
3. **[Command]** — [specific reason based on context]

Pick 2-4 commands that make the most sense given:

  • What's missing (no vision doc → suggest /arc:vision)
  • What's stale (old plans → suggest /arc:tidy)
  • What just changed (recent UI edits → suggest /arc:design or /arc:audit --harden)
  • What could be improved (no tests → suggest /arc:testing)

Rules

  • Don't invoke any other skills. This is information only.
  • Don't ask questions. Output the catalog and recommendations, then stop.
  • Keep context gathering under 5 seconds. Quick checks only, no deep exploration.
  • Show ALL commands. Don't hide irrelevant ones — annotate them so users learn they exist.
  • Be specific about relevance. "Low relevance — no UI components found" not just "Low relevance."
Related skills
Installs
3
Repository
howells/arc
GitHub Stars
20
First Seen
Mar 29, 2026