# Skill Authoring

> Create, organize, and validate Codex skills in this repository. Use when adding a new skill folder, editing SKILL.md or agents/openai.yaml, choosing optional resources, or checking repo conventions before publishing.

- Skill: `fengbuming/skill-authoring` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add fengbuming/skill-authoring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/fengbuming/skill-authoring/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: fengbuming (https://skillmd.com/u/fengbuming)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/fengbuming/skill-authoring

---


# Skill Authoring

## Overview

Use this skill to keep the skills repository consistent and easy to extend.

## Repository Rules

Follow the layout and naming rules in [repo-structure.md](references/repo-structure.md).

## Add Or Update A Skill

1. Create or rename the skill folder under `skills/<skill-name>/`.
2. Keep the skill name lowercase and hyphen-separated.
3. Write a concise `SKILL.md` with a precise trigger description.
4. Add `agents/openai.yaml` metadata that matches the skill.
5. Create `scripts/`, `references/`, or `assets/` only when the skill needs them.
6. Move long explanations out of `SKILL.md` and into `references/`.
7. Validate the skill folder before publishing or copying it into your Codex skills path.

## Validate

Use the Codex skill-creator validator on each skill folder after editing.

## Resources

- `references/repo-structure.md`: canonical layout and authoring rules