claude-code

Files (7)

• SKILL.md
• install.md · references/
• management.md · references/
• permissions.md · references/
• sessions.md · references/
• streaming.md · references/
• worktrees.md · references/

SKILL.md (first lines)

# Claude Code

## Options and boundaries

Default: `claude --print --dangerously-skip-permissions --output-format text "<prompt>"`
from the target directory; model omitted; parent wait 15m. Calling this skill
authorizes that run: pass `--dangerously-skip-permissions` without asking.
There is no `--yolo` flag; this skip is the yolo run. Print alone can write.
"Read-only" / "plan" uses `--permission-mode plan` and omits the skip flag.
"Use <model>" adds `--model`. "Interactive" / "TUI" omits `--print` and the
skip flag. "Resume <id>" adds `--resume`; "continue" adds `--continue`; both wait
until exit and keep the same permission choice as the selected mode.
"Worktree [name]" adds `--worktree [name]`; record the emitted path.
"JSON" / "stream-json" selects that print output. Missing needed values or
conflicting options are `BLOCKED`.

For plan, restricted, or another named permission mode, follow
`references/permissions.md`. A default run does not stop for a permission
prompt. `claude help` starts a session: use `claude --help`.
`remote-control` is not documentation.

## 1. Resolve

Fix absolute workspace, prompt, mode, session, worktree, output, and wait.
Check binary and `claude auth status --text` without exposing secrets.
Missing binary → follow `references/install.md`; missing auth → `BLOCKED`
unless login was requested. Wrong cwd blocks.
Record `cmd | workspace | mode | session | worktree | wait | evidence | terminal`.
Done when target, binary, auth, and the permission choice are fixed.

## 2. Run

Build argv from those options and quote the prompt literally. Default text
is quiet until process exit; silence is not a hang. Wait for exit or the
recorded deadline, and kill only this run's PID when that deadline expires.
Nonzero exit: capture stderr, inspect the tree, and report `BLOCKED`.
Do not ask the user and do not add a second bypass.

For JSON/stream output, follow `references/streaming.md`. For resume,
continue, or background sessions, follow `references/sessions.md`.
For worktrees or parallel runs, follow `references/worktrees.md`.
For an asked-for TUI or management command, follow `references/management.md`.
A rejected flag requires scoped `--help`, not a guessed replacement.
Done when the process exits, an intended live handle is recorded, or a
failure is reported.

## 3. Verify and report

Inspect status and diff; CLI text is not proof. Run the narrowest covering
tests for edited executable code. Plan mode must leave the tree unchanged.
Verify each worktree and any integrated tree. Clean up only this run's
sessions/worktrees unless explicitly kept; preserve auth, MCP, and plugins.
Report command, mode, session/worktree, wait, and outcome evidence.
Done when every requested outcome is observed or a blocker is evidenced.

Terminals: `SUCCESS`, `NO_CHANGES`, `BLOCKED`.

From prathamdby/skills, MIT.

More from prathamdby/skills