# Skill Authoring

> Use this when creating, improving, reviewing, deduplicating, or documenting Codex skills for this library.

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

---


# Skill Authoring

## Goal

Create high-quality skills that Codex can discover and apply reliably.

## When to use

Use when adding a new skill, improving an existing skill, reviewing skill quality, creating references, or deduplicating overlapping skills.

## When not to use

Do not use for normal product implementation unless the task is to update the skill library itself.

## Inputs

Inspect the proposed skill purpose, existing similar skills, `docs/SKILL_SPEC.md`, `docs/STYLE_GUIDE.md`, and `docs/QUALITY_RUBRIC.md`.

## Workflow

1. Define the single job of the skill.
2. Search for overlapping skills before creating a new one.
3. Write precise activation frontmatter.
4. Put the durable process in `SKILL.md`.
5. Move long examples to `references/`.
6. Add scripts only for deterministic checks.
7. Run validation and duplicate checks.
8. Generate the catalog after changes.

## Quality bar

A good skill is narrow, discoverable, safe, testable, and easy to maintain.

## Validation

Run `npm run validate`, `npm test`, and `npm run catalog`.

## Final response

Report the skill created or changed, why it is not duplicated, validation output, and any future improvement ideas.