Design effective system prompts for custom agents. Use when creating agent system prompts, defining agent identity and rules, or designing high-impact prompts that shape agent behavior.
Design effective system prompts that establish agent identity, rules, and behavior. Use when creating custom agents, defining expertise domains, or building specialized assistants with clear boundaries and examples.
/plugin marketplace add melodic-software/claude-code-plugins/plugin install google-ecosystem@melodic-softwareThis skill is limited to using the following tools:
Design effective system prompts for custom agents that establish identity, rules, and behavior.
Create system prompts that shape agent behavior across all conversations. System prompts are orders of magnitude more important than user prompts.
| Aspect | System Prompt | User Prompt |
|---|---|---|
| Scope | All conversations | Single task |
| Persistence | Affects everything | Per-request |
| Impact | Orders of magnitude higher | Lower blast radius |
| Sections | Purpose, Instructions, Examples | All sections |
Define who the agent is and what it does.
## Purpose
You are a security expert specializing in code review.
Your role is to identify vulnerabilities and suggest fixes.
You focus on OWASP Top 10 and secure coding practices.
Guidelines:
Establish rules, constraints, and boundaries.
## Instructions
- Focus only on security concerns
- Always explain the reasoning behind findings
- Prioritize issues by severity (Critical, High, Medium, Low)
- Do not modify code without explicit permission
- When uncertain, ask clarifying questions
Guidelines:
Shape behavior through concrete examples.
## Examples
### Example 1: SQL Injection Finding
**Input:** "Review this login function"
**Output:** "Found SQL injection vulnerability at line 42. The user input is directly concatenated into the query string. Recommendation: Use parameterized queries instead."
### Example 2: Out of Scope Request
**Input:** "Fix this CSS styling issue"
**Output:** "That's outside my security focus. I specialize in security vulnerabilities, not styling. Consider consulting a frontend expert for CSS issues."
### Example 3: Clean Code
**Input:** "Check this authentication module"
**Output:** "Reviewed the authentication module. No security vulnerabilities found. The code follows secure practices: uses parameterized queries, hashes passwords with bcrypt, and implements rate limiting."
Guidelines:
Answer:
Answer:
For each key scenario:
Check:
| Avoid | Why | Instead |
|---|---|---|
| Detailed workflows | Reduces autonomy | High-level guidelines |
| Dynamic variables | System prompt is static | Use user prompts |
| Prescriptive formats | Over-constrains | Flexible guidelines |
| Everything "just in case" | Context bloat | Only essentials |
---
name: agent-name
description: When to use this agent (for auto-delegation)
tools: [minimal tool set]
model: sonnet
color: blue
---
# Agent Name
## Purpose
[Identity and role definition]
## Instructions
[Rules and constraints]
## Examples
### Example 1: [Scenario]
**Input:** [typical input]
**Output:** [ideal output]
### Example 2: [Edge Case]
**Input:** [edge case input]
**Output:** [handling output]
### Example 3: [Boundary]
**Input:** [out-of-scope request]
**Output:** [how to decline/redirect]
When designing a system prompt:
## System Prompt Design
**Agent Name:** [name]
**Domain:** [expertise area]
**Model:** [sonnet/opus/haiku]
### Purpose
[2-3 sentences defining identity]
### Instructions
- [rule 1]
- [rule 2]
- [rule 3]
### Examples
**Example 1:** [scenario]
- Input: [input]
- Output: [output]
**Example 2:** [scenario]
- Input: [input]
- Output: [output]
### Validation
- [ ] Purpose is specific
- [ ] Instructions are actionable
- [ ] Examples are diverse
- [ ] Boundaries are clear
Focus: Deep domain knowledge
## Purpose
You are an expert in [domain] with deep knowledge of [specifics].
Focus: Validation and safety
## Instructions
- Validate all inputs against [criteria]
- Block requests that [conditions]
- Log suspicious activity
Focus: Format conversion
## Examples
### Input Format
[format A]
### Output Format
[format B]
"System prompts are orders of magnitude more important than user prompts. They run once and affect everything."
Date: 2025-12-26 Model: claude-opus-4-5-20251101
This skill should be used when the user asks to "create an agent", "add an agent", "write a subagent", "agent frontmatter", "when to use description", "agent examples", "agent tools", "agent colors", "autonomous agent", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.
This skill should be used when the user asks to "create a slash command", "add a command", "write a custom command", "define command arguments", "use command frontmatter", "organize commands", "create command with file references", "interactive command", "use AskUserQuestion in command", or needs guidance on slash command structure, YAML frontmatter fields, dynamic arguments, bash execution in commands, user interaction patterns, or command development best practices for Claude Code.
This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate tool use", "implement prompt-based hooks", "use ${CLAUDE_PLUGIN_ROOT}", "set up event-driven automation", "block dangerous commands", or mentions hook events (PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification). Provides comprehensive guidance for creating and implementing Claude Code plugin hooks with focus on advanced prompt-based hooks API.