Our review

Generates a customized skill template from repeated instructions or workflows, packaging expertise for AI agents to automatically load.

Strengths

Automates repetitive instructions into reusable skills
Reduces manual effort by packaging expertise
Follows official skill specification for compatibility
Provides validation and user confirmation steps

Limitations

Requires at least 2-3 repetitions to warrant a skill
Output limited to 500 lines; longer skills need a references/ folder
Only works with AI agents that support skills (primarily Claude Code)

When to use it

When you find yourself repeating similar instructions to an AI agent 2-3 times with 90% identical content.

When not to use it

When the task is one-off or instructions vary significantly between uses.

Examples

Create a skill for code review

I keep asking you to review my code using the same conventions. Generate a skill for that.

Package my commit message workflow

I've given you the same instructions for commit messages three times now. Turn it into a skill.

Automate project setup

Every time I start a new project, I want you to follow the same setup steps. Make it a skill.

name: 'aidd:01:generate_skill' description: 'Generate a customized skill based on repeated patterns and user workflows.' argument-hint: 'Description of the workflow to package as a skill'

Goal

Generate a skill template from repeated instructions or workflows, packaging expertise that AI agents load automatically.

Context

Official skills specification

These rules come from the official Claude Code documentation. Interpret them in a generalist and agnostic way (applicable to other AI tools).

@https://code.claude.com/docs/en/skills.md

Skill template

@aidd_docs/templates/aidd/skill.md

Existing skills

@.claude/skills/

IDE Mapping

Mandatory mapping for IDE integration (file paths, naming, extensions):

@.claude/rules/04-tooling/ide-mapping.md

Rules

Frontmatter rules

name: lowercase, dashes for spaces, max 64 chars
description:
- 3rd person ("Generates...", "Creates..."), max 1024 chars
- MUST include "Use when..." with explicit triggers
- Include natural keywords users would say

Content rules

Skill is worth it if instructions repeated 2-3x
SKILL.md < 500 lines (otherwise → references/)
Max 1 level of references (agent does not read nested refs)
Less is more - do not over-explain the obvious

Process Steps

Auto-detect IDE: Check which IDE folders exist and ask user to confirm
Identify the pattern
- Verify that the same instructions have been given to the AI at least 2-3 times
- Confirm that 90% of instructions are identical between usages
- Ensure the task requires specific conventions
Ask clarifying questions
- What triggers/contexts should activate this skill?
- What keywords does the user naturally use?
- Are there scripts or references to include?
Structure the skill: respect the given template
Validate with user
- Display the generated SKILL.md
- Request confirmation before writing
- Propose folder: .claude/skills/<skill-name>/
Output
- Write to .claude/skills/<skill-name>/SKILL.md
- Add references/ folder if > 500 lines

Generate Customized Skill

Recommended for