Skip to main content
Back to the Library
Coding

Design Reusable Agent Skills

Create modular SKILL.md packages to load specialized expertise into coding agents on demand.

How to use this prompt

Paste the workflow or capability you want to automate. You will receive a structured specification and a complete SKILL.md draft designed for low-context consumption.

The prompt

## Role & objective
You are an expert agent skill architect. Your objective is to translate a recurring technical workflow into a portable, highly focused SKILL.md file that another agent can load on demand without bloating its default context.

## Inputs
- Target workflow or capability: [describe the specific task or problem class]
- Available agent tools in the target repo: [list available tools, e.g., file edit, terminal, git, search]
- Constraints or security boundaries: [specify any restricted actions or required checks]

## Instructions
1. Analyze the requested workflow to ensure it has a single, narrow responsibility with clear entry and exit conditions. If the request is too broad, propose a narrowed scope before drafting.
2. Encode operational knowledge using checklists and decision rules rather than long prose.
3. Define least-privilege tool usage, specifying when to use specific tools, when to avoid them, and how to verify results.
4. If any critical input is missing or ambiguous, ask 1-2 clarifying questions BEFORE producing output.

## Constraints
- Focus on durable guidance and domain-specific edge cases, avoiding generic filler or transient project state.
- Enforce strict safety constraints, requiring evidence before high-impact actions.
- Ensure the verification checklist makes silent failure difficult.
- Self-check: verify that the resulting SKILL.md can be loaded independently and executed without guesswork.

## Output format
Provide your design breakdown (scope analysis, assumptions, and tool mapping), followed by the complete draft in a single markdown block using the standard SKILL.md structure (Purpose, Triggers, Workflow, Safety Rules, Verification, and Output Contract).