# Nz Skill Creator

> Create or update skills inside the NZ Life Skills repository while keeping package docs, manifests, and bundle-level agent indexes in sync. Use when Codex needs to add a new repository skill, update an existing skill's package metadata, register a skill in docs/skills.json and docs/bundles.json, refresh docs/.well-known/agent-skills/*, or keep README and docs pages aligned with the repository's bundle structure. Triggers include requests like "add a new skill to this repo", "update all affected indexes and manifests", "register this skill in NZ-life-skills", or "use the add-skill-template workflow".

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

---


# NZ Skill Creator

## Overview

Use this skill to create repo-native skills for `NZ-life-skills` without leaving package docs or manifests stale. It combines the generic `$skill-creator` workflow with this repository's template, bundle model, and registration scripts.

## Workflow

1. Read [../../docs/add-skill-template.md](../../docs/add-skill-template.md).
2. Read [references/repo-playbook.md](references/repo-playbook.md).
3. If the active environment exposes `$skill-creator`, follow it for scaffolding and validation. Otherwise, mirror its workflow directly.
4. Prefer `scripts/create_skill.py` when adding a new repo-native skill from scratch.
5. Create or update the skill folder under `skills/<name>/`.
5. Ensure the skill includes:
   - `SKILL.md`
   - `agents/openai.yaml`
   - `references/current-guidance.md` unless a better reference filename is justified
6. Register the skill in repository manifests with:
   - `scripts/register_skill.py`
7. Run:
   - `python3 scripts/register_skill.py ...`
   - the `quick_validate.py` validator from the active `$skill-creator` installation, if available
8. Review the rendered docs and only make manual follow-up edits when localization or package positioning needs extra nuance.

## What This Skill Automates

Use the bundled script to upsert and sync:

- `docs/skills.json`
- `docs/bundles.json`
- `docs/.well-known/agent-skills/index.json`
- `docs/.well-known/agent-skills/<bundle>.json`
- `README.md`
- `README.zh-CN.md`
- `docs/index.md`
- `docs/package-structure.md`
- `docs/skills-index.md`
- `docs/for-agents.md`

The manifests now support bilingual metadata fields such as `title_zh`, `description_zh`, `name_zh`, and `description_zh`, so Chinese README generation can stay aligned with the machine-readable registry.

## One-Command Creation

Use `scripts/create_skill.py` to scaffold, register, and validate a new skill in one run.

It handles:

- calling the generic `init_skill.py` scaffold
- writing repo-native `SKILL.md` and `references/current-guidance.md`
- creating `agents/openai.yaml`
- registering the skill in manifests and docs
- running a built-in structural validation pass

## Command Pattern

Run the registration step from the repository root:

```bash
python3 skills/nz-skill-creator/scripts/register_skill.py \
  --repo-root . \
  --name <skill-name> \
  --bundle <bundle-slug> \
  --geography <nz|global|mixed> \
  --audience <audience> \
  --policy-sensitive <true|false> \
  --official-sources-required <true|false> \
  --description "<one-sentence skill description>"
```

If the bundle is new, also pass:

```bash
  --bundle-title "<human title>" \
  --bundle-description "<bundle description>"
```

## Answering Rules

- Prefer existing bundles unless the new skill clearly sits outside the current package model.
- Keep the new skill's frontmatter and `docs/skills.json` aligned.
- Treat `docs/skills.json` and `docs/bundles.json` as the machine-readable source used to render package docs.
- Keep English and Chinese metadata aligned when adding or renaming a skill.
- If a reference filename differs from `current-guidance.md`, pass it explicitly to the script and verify that the local path and GitHub URL both match.
- When the change affects package positioning in a nuanced way, review both README files after the script run even if they were auto-generated.

## References

- Repository template: [../../docs/add-skill-template.md](../../docs/add-skill-template.md)
- Repo playbook: [references/repo-playbook.md](references/repo-playbook.md)
- One-command scaffold: [scripts/create_skill.py](scripts/create_skill.py)
- Registration script: [scripts/register_skill.py](scripts/register_skill.py)