# Skill Authoring

> Create or update project-specific skills in this repo. Use when asked to make new skills, modularize workflows, or build skill packs for this codebase.

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

---


# Skill Authoring

## Overview
Create concise, modular skills stored under `skills/` in this repo.

## Workflow
1. Define triggers and scope with concrete user examples.
2. Choose a short skill name (lowercase, hyphen).
3. Initialize with `init_skill.py` from the system skill-creator.
4. Write SKILL.md in imperative form and keep it lean.
5. Add scripts or references only when they save repeated work.
6. Package with `package_skill.py` only when requested.
7. Run the QA harness to generate matrices and results templates.

## References
- Skill template: `references/skill_template.md`
- QA checklist: `references/qa_checklist.md`
- QA matrix template: `references/qa_matrix_template.md`

## QA Harness
- Generate QA artifacts: `python3 scripts/skill_qa_harness.py`
- Overwrite existing outputs: `python3 scripts/skill_qa_harness.py --force`

## Local Conventions
- Prefer small, single-purpose skills plus an orchestrator.
- Put reusable commands in scripts; keep references one hop from SKILL.md.
- Avoid extra docs (README, changelog, etc.).
- Add honesty guardrails when a skill can produce overconfident outputs.
- Add acceptance criteria sections so QA can be objective.
- Use repo-relative paths in skill lists (AGENTS.md) for portability.