create-instructions

---

name: create-instructions description: 'Create an instructions file (.instructions.md) for a project rule or convention.' argument-hint: What rule or convention to enforce? disable-model-invocation: true

Related skill: agent-customization. Load and follow instructions.md for template and principles.

Guide the user to create an instructions file.

Extract from Conversation

First, review the conversation history. If the user has been correcting the agent's output or asking for specific patterns (e.g., "always use X", "never do Y", "follow this style"), generalize that into a persistent instruction. Extract:

• Corrections or preferences mentioned during the conversation
• Coding patterns the user enforced or requested
• Project-specific conventions referenced

Clarify if Needed

If no clear rule emerges from the conversation, clarify:

• Should this apply everywhere or only to specific files?
• Which technologies or file types are affected?
• Is this a hard rule or a preference?

Explore the codebase using subagents if you need more context.

Iterate

1. Draft the instruction and save it.
2. Identify the most ambiguous or weak parts and ask about those.
3. Once finalized, summarize what the instruction enforces, suggest example prompts to see it in action, and propose related customizations to create next.

Remember to follow the agent-customization guidelines to create highly effective instructions.