skills: Instructions file for Codex

Skills Generator

Generate Agent Skills from project documentation.

PLEASE STRICTLY FOLLOW THE BEST PRACTICES FOR SKILL: https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices

• Focus on agents capabilities and practical usage patterns.
• Ignore user-facing guides, introductions, get-started, install guides, etc.
• Ignore content that LLM agents already confident about in their training data.
• Make the skill as concise as possible, avoid creating too many references.

Skill Source Types

There are two types of skill sources. The project lists are defined in meta.ts:

Type 1: Generated Skills (sources/)

For OSS projects without existing skills. We clone the repo as a submodule and generate skills from their documentation.

• Projects: Vue, Nuxt, Vite, UnoCSS
• Workflow: Read docs → Understand → Generate skills
• Source: sources/{project}/docs/

Type 2: Synced Skills (vendor/)

For projects that already maintain their own skills. We clone their repo as a submodule and sync specified skills to ours.

• Projects: Slidev, VueUse
• Workflow: Pull updates → Copy specified skills (with optional renaming)
• Source: vendor/{project}/skills/{skill-name}/
• Config: Each vendor specifies which skills to sync and their output names in meta.ts

Type 3: Hand-written Skills

For skills that are written by Anthony Fu with his preferences, experience, tastes and best practices.

You don't need to do anything about them unless being asked.

Repository Structure

.
├── meta.ts                     # Project metadata (repos & URLs)
├── instructions/               # Instructions for generating skills
│   └── {project}.md            # Instructions for generating skills for {project}
│
├── sources/                    # Type 1: OSS repos (generate from docs)
│   └── {project}/
│       └── docs/               # Read documentation from here
│
├── vendor/                     # Type 2: Projects with existing skills (sync only)
│   └── {project}/
│       └── skills/
│           └── {skill-name}/   # Individual skills to sync
│
└── skills/                     # Output directory (generated or synced)
    └── {output-name}/
        ├── SKILL.md           # Index of all skills
        ├── GENERATION.md       # Tracking metadata (for generated skills)
        ├── SYNC.md             # Tracking metadata (for synced skills)
        ├── references/
        │   └── *.md            # Individual skill files
        ├── scripts/            # Optional: executable scripts
        └── assets/             # Optional: templates, resources