agentsclimarketplace

Nz skill creator

Skill pengqianhan/NZ-life-skills/skills/nz-skill-creator

Practical New Zealand life skills for international students, especially Chinese newcomers, with official-source-backed guides for Codex and Claude Code.

Install
npx -y skills add pengqianhan/NZ-life-skills --skill nz-skill-creator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.md

4.4 KB, as published. Nobody here has run it

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

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.