Guide to writing ai-cli mode files. Use when creating modes for non-interactive Claude Code sessions — preconfigured agent runs with locked-in system prompts, model selection, and prompt wrappers.
Creates preconfigured agent modes for non-interactive Claude Code sessions with custom prompts and model selection.
npx claudepluginhub captaincrouton89/crouton-kitThis skill inherits all available tools. When active, it can use any tool Claude has access to.
Modes are markdown files that configure non-interactive Claude Code sessions via the Agent SDK. Each mode defines a system prompt, model, and optional prompt wrapper — producing a preconfigured, fire-and-forget agent.
| Location | Scope | Precedence |
|---|---|---|
.claude/.ai/modes/<name>.md | Project-local | Wins over built-in |
ai-cli/modes/<name>.md | Built-in (bundled) | Fallback |
---
model: opus
system-prompt-mode: append
---
| Field | Required | Values | Default |
|---|---|---|---|
model | Yes | Any valid model ID | — |
system-prompt-mode | No | append, replace | append |
append — mode's system prompt is appended to the default Claude Code system prompt. The agent retains all standard capabilities.replace — mode's system prompt completely replaces the default. Use for fully custom agent personas.Everything after the frontmatter (before ## Prompt Wrapper if present) becomes the system prompt content.
---
model: claude-sonnet-4-5-20250929
system-prompt-mode: append
---
You are a security auditor. Report vulnerabilities only — never edit code.
Focus on: injection, auth bypass, data exposure, SSRF.
A ## Prompt Wrapper heading defines a template applied to the user's -p argument. Use {{prompt}} as the placeholder.
---
model: claude-opus-4-6
system-prompt-mode: append
---
You are a systematic debugger. Investigate only — no code changes.
## Prompt Wrapper
Debug the following issue. Diagnose root cause — don't fix.
Issue description:
{{prompt}}
Without a prompt wrapper, the -p argument is passed directly as the user prompt.
# Built-in mode
ai -m review -p "src/auth/"
# Project-local mode
ai -m security-audit -p "check the API layer"
# List all available modes (built-in + local)
ai -l
append for most modes — the agent keeps Claude Code's full toolset; you're just narrowing its focusreplace sparingly — only when you need a completely custom personageneral — sonnet, append, no wrapper. Minimal: "direct, efficient assistant"debug — opus, append, wrapper frames input as "Issue description". Multi-phase methodology in system prompt.review — opus, append, wrapper frames input as review target. Detailed concern taxonomy in system prompt.Modes are callable from hooks, scripts, and other tools:
# In a pre-commit hook
ai -m validate-commit -p "$(git diff --cached)"
# In a CI script
ai -m review -p "$(git diff origin/main...HEAD)"
Expert guidance for Next.js Cache Components and Partial Prerendering (PPR). **PROACTIVE ACTIVATION**: Use this skill automatically when working in Next.js projects that have `cacheComponents: true` in their next.config.ts/next.config.js. When this config is detected, proactively apply Cache Components patterns and best practices to all React Server Component implementations. **DETECTION**: At the start of a session in a Next.js project, check for `cacheComponents: true` in next.config. If enabled, this skill's patterns should guide all component authoring, data fetching, and caching decisions. **USE CASES**: Implementing 'use cache' directive, configuring cache lifetimes with cacheLife(), tagging cached data with cacheTag(), invalidating caches with updateTag()/revalidateTag(), optimizing static vs dynamic content boundaries, debugging cache issues, and reviewing Cache Component implementations.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.