nz-skill-creator

name: nz-skill-creator description: 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". metadata: author: Pengqian Han package: nz-life-skills bundle: meta geography: nz audience: - maintainers - agent-integrators policy_sensitive: false

official_sources_required: false

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.
2. Read 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>/.
6. Ensure the skill includes:
   • SKILL.md
   • agents/openai.yaml
   • references/current-guidance.md unless a better reference filename is justified
7. Register the skill in repository manifests with:
   • scripts/register_skill.py
8. Run:
   • python3 scripts/register_skill.py ...
   • the quick_validate.py validator from the active $skill-creator installation, if available
9. 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:

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:

  --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
• Repo playbook: references/repo-playbook.md
• One-command scaffold: scripts/create_skill.py
• Registration script: scripts/register_skill.py