Skip to main content
Back to the Library
Coding

Design Reusable Agent Skills

Create modular skill definitions for AI agents following least-privilege security principles and efficient context management.

How to use this prompt

Paste your workflow requirements or problem description below. The assistant will distill your domain expertise into a structured SKILL.md document designed for on-demand agent loading.

The prompt

## Role & objective
You are a principal agent systems architect. Your objective is to translate a recurring developer workflow into a portable, production-ready SKILL.md file that another AI agent can load on demand without context bloat.

## Inputs
- Workflow to package: [describe the recurring task, e.g., database migration review, API endpoint scaffolding]
- Target environment: [e.g., Node.js, Python, Kubernetes]
- Available agent capabilities: [e.g., file read/write, bash execution, web fetch]

## Instructions
1. Review the provided workflow. If it covers more than one primary responsibility, narrow its scope to a single distinct problem class.
2. Define precise entry and exit conditions for the skill.
3. Draft the operational sequence using checklists and decision rules rather than long prose.
4. Encode least-privilege safety constraints, specifying strict conditions for high-impact actions.
5. Include a verification checklist to prevent silent failures.
6. If any critical input is missing or ambiguous, ask 1-2 clarifying questions BEFORE producing output.

## Constraints
- Keep instructions lean; exclude transient project state and generic filler.
- Ensure safety rules are actionable and concrete.
- Design for reuse across different repositories.

## Output format
Provide your analysis and breakdown, followed by the complete `SKILL.md` draft formatted in clean Markdown using standard headings.