Skill

Compatibility: AskUserQuestion falls back to numbered list on non-Claude-Code platforms.

Skill Requirements

command -v npx >/dev/null 2>&1 || echo "MISSING: npx"

Inline Usage

Pass your intent directly on the invocation line — new and explore proceed immediately with no opening question when a description is provided.

/skill new add a /summarize command that condenses long files
/skill explore linear integration
/skill update linear-push

Critical Rules

• Markdown output: soft-wrap prose, never hard-wrap — when this skill writes a .md artifact (SKILL.md, skill docs, critique/review reports, or any generated document), write each paragraph as one continuous line; do not insert manual newlines to wrap prose at a fixed column width. Newlines still separate paragraphs, list items, headings, and code fences. (If a markdown formatter is available, prettier --prose-wrap never enforces this deterministically.)

• Model tiers, never model IDs — the skill agents declare metadata: model-tier: (or a **Model tier:** line) and workflows use model-tier: tokens; the platform maps tiers to concrete models (see references/model-tiers.md). Never hardcode a provider model ID (such as claude-*) in this skill.

• Never execute workflow logic here — this file only parses args and dispatches

• Step 0 always runs first — no exceptions

• Unknown verb → run help.md — never error silently

• Pass all remaining args through — workflow receives $REMAINING_ARGS unchanged

• Workflow files are authoritative — do not duplicate workflow logic in this file

• See references/workflows/ for per-verb behaviour; see references/ for all templates

Step 0: Parse Arguments

The raw invocation args (filled by Claude Code / OpenCode slash commands): $ARGUMENTS. If this line is not filled in, read the verb and remaining args from the user's current message.

VERB="[first non-flag argument, or empty]"
REMAINING_ARGS="[everything after VERB, preserving order and flags]"

# Normalise aliases
case "$VERB" in
  "")           VERB="help" ;;
  "create")     VERB="new" ;;
  "improve")    VERB="update" ;;
  "review")     VERB="critique" ;;
  "scaffold")   VERB="scaffold" ;;
  "init")       VERB="scaffold" ;;
  "bootstrap")  VERB="scaffold" ;;
esac

Step 1: Dispatch to Workflow

Read and execute references/workflows/{VERB}.md, passing $REMAINING_ARGS as the argument string.

If references/workflows/{VERB}.md does not exist, fall back to references/workflows/help.md and note the unknown verb.

Workflow Index

• explore (references/workflows/explore.md) — research existing skills on agentskill.sh before building
• new (references/workflows/new.md) — create a new Claude Code compatible skill from a description
• learn (references/workflows/learn.md) — extract a skill from a local path, URL, or PR/MR diff
• consolidate (references/workflows/consolidate.md) — merge two skills into one, deduplicating workflows
• update (references/workflows/update.md) — update or improve an existing skill
• critique (references/workflows/critique.md) — evaluate skill quality across 5 dimensions
• feedback (references/workflows/feedback.md) — open a GitHub or GitLab issue to report a skill problem
• scaffold (references/workflows/scaffold.md) — initialise a new skill repo with annotated example skills
• help (references/workflows/help.md) — print command reference