Universal AI Skill Creator

Systematic approach to creating, auditing, and optimizing AI agent skills — adapted from Anthropic's skill-creator to work with any platform (OpenCode, Claude, Qwen Code, Cline, Cursor).

What's Inside

SKILL.md

The universal skill creator instruction — a complete workflow for building SKILL.md files from scratch. Includes:

• 7-step process (clarify → draft → test → iterate)
• YAML frontmatter structure
• Testing methodology
• Description optimization
• Cross-platform compatibility

01_anthropic_analysis.md

Structural analysis of Anthropic's original skill-creator — file tree, role of each component, dependency mapping.

02_audit.md

Audit of 21 files from Anthropic's implementation: what to keep, adapt, or remove for a universal version. Covers agents, scripts, schemas, and eval-viewer.

03_design.md

Design document for the universal adaptation — rusification, platform-agnostic language, and minimal viable version.

01_theses.md

Key theses on OpenCode architecture — benefits of structured knowledge, cognitive load reduction, AI agent automation.

04_article_architecture.md

OpenCode architecture deep-dive with Mermaid diagrams — Core Engine, Tooling System, Skill Loader, abstraction layers.

05_skill_uniqueness.md

Why Skills matter in OpenCode — isolation, reusability, versioning for AI agent capabilities.

Key Insight

Anthropic's skill-creator is powerful but tightly coupled to Claude Code's sub-agent architecture. The core value isn't in the scripts — it's in the systematic process:

1. Understand what the user wants
2. Ask clarifying questions
3. Write a draft
4. Test on concrete examples
5. Show results to user
6. Improve based on feedback
7. Repeat until good

This process is universal and platform-independent.

How to Use

Copy SKILL.md into your agent's skills directory. The skill triggers when a user wants to create, edit, or optimize an AI agent skill.

Files

├── SKILL.md                    # Universal skill creator (main output)
├── 01_anthropic_analysis.md    # Structural analysis of original
├── 02_audit.md                 # File-by-file audit (21 files)
├── 03_design.md                # Universal design document
├── 01_theses.md                # OpenCode architecture theses
├── 04_article_architecture.md  # Architecture deep-dive with Mermaid
└── 05_skill_uniqueness.md      # Skills importance in OpenCode

Tech Stack

• Pure Markdown — no dependencies
• YAML frontmatter for skill metadata
• Works with any agent that supports SKILL.md format