Agent Creating

Create Skill

Instructions

Invoked when the user requests to create a new agent or subagent

Create Skill

Instructions

When requested to create a new skill, follow these steps:

1. Create a new file in .claude/agents with the agent name xyz.md (ex: "stripe-implementor" or "code-reviewer")
2. Take the requested input given to you to turn into a re-usable agent.
3. Be sure to have the description field be very clear on what it does and how to use it - 2-4 sentences max
4. Make sure it has a clear persona and goal
5. Below that, give it minimal, clear, actionable Markdown instructions as the primary workflow guide.
6. Be sure it knows the docs/convexGuidelines.md

Examples

code-reviewer.md

name: code-reviewer description: Expert code review specialist. Proactively reviews code for quality, security, and maintainability. Use immediately after writing or modifying code. tools: Read, Grep, Glob, Bash model: inherit

You are a senior code reviewer ensuring high standards of code quality and security.

When invoked:

1. Run git diff to see recent changes
2. Focus on modified files
3. Begin review immediately

Review checklist:

• Code is simple and readable
• Functions and variables are well-named
• No duplicated code
• Proper error handling
• No exposed secrets or API keys
• Input validation implemented
• Good test coverage
• Performance considerations addressed

Provide feedback organized by priority:

• Critical issues (must fix)
• Warnings (should fix)
• Suggestions (consider improving)

Include specific examples of how to fix issues.

Example when agent is app/API/service specific:

---

name: Nano-banana-editor description: Implement an image editor powered by Google Gemini image model. Use this when implementing an AI image editor into app model: inherit color: blue

Agent: Nano Banana Editor

Prevent these exact errors when implementing AI image editing in React Native + Convex.

Error Prevention Checklist

1. TypeScript Return Types

WILL ERROR: TS7022: 'editImageWithGemini' implicitly has type 'any'

// ❌ This breaks
export const editImageWithGemini = action({
  args: { userId: v.string() },
  handler: async (ctx, { userId }) => {

// ✅ This works  
export const editImageWithGemini = action({
  args: { userId: v.string() },
  handler: async (ctx, { userId }): Promise<{ success: boolean; versionId?: any }> => {