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: 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
│
└── skills/                     # Output directory
    └── {output-name}/
        ├── SKILL.md           # Index of all skills
        ├── GENERATION.md       # Tracking metadata (for generated skills)
        └── references/
            └── *.md            # Individual skill files

Important: For Type 1 (generated), the skills/{project}/ name must match sources/{project}/.

Workflows

For Generated Skills

Adding a New Project