# New Skill

> Scaffold a new skill directory under skills/ that passes scripts/audit_skills.py on first run. Use when adding a new portable agent skill to this repo.

- Skill: `genericservice/new-skill` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add genericservice/new-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/genericservice/new-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: genericservice (https://skillmd.com/u/genericservice)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/genericservice/new-skill

---


# new-skill

Creates a new skill at `skills/<name>/` with a valid `SKILL.md` (correct frontmatter, kebab-case name, semver version) so it passes `python3 scripts/audit_skills.py skills` immediately.

## Usage

```bash
bash "$CLAUDE_PROJECT_DIR/.claude/skills/new-skill/scripts/scaffold.sh" <skill-name> "<one-line description>"
```

`<skill-name>` must be kebab-case (lowercase letters, digits, hyphens — no underscores, no dots).

## What it does

1. Validates the name against the audit script's kebab-case regex.
2. Refuses to overwrite an existing `skills/<skill-name>/`.
3. Copies `templates/SKILL.md` into `skills/<skill-name>/SKILL.md`, substituting `{{name}}` and `{{description}}`.
4. Runs `python3 scripts/audit_skills.py skills` and reports the result.

## After scaffolding

- Flesh out the SKILL.md body (Workflow, references, examples).
- Add `references/`, `templates/`, `scripts/`, `examples/` directories only if the skill needs them.
- Bump the `version` in frontmatter when you make changes (see CLAUDE.md → Versioning).
- The `package-skill.sh` PostToolUse hook will rebuild `dist/<skill-name>.skill` automatically on the first edit.