skilld
All skills
boshu2 avatar

/skill-builder

@860fce8
by Boboshu2/agentops446 stars
42

Create, adapt, consolidate or repair skill packages and projections. Use when: authoring guidance, descriptions or structure; Skill Eval measures behavioral benefit.

Ask your Agent

Use this Skill: https://skilld.dev/gh/boshu2/agentops/skill-builder

This session only. Nothing lands on disk.

referencescodex-parity.md

≈608 tokens on demand. Your agent reads this file only when SKILL.md points to it.

Codex Parity Repair

Use this workflow when skills/<name>/SKILL.md is canonically correct but skills-codex/<name>/SKILL.md has drifted into bad Codex UX in the checked-in runtime artifact.

Principles

  1. skills/<name>/SKILL.md remains the canonical workflow contract.
  2. skills-codex/<name>/ is the generated checked-in Codex runtime artifact; repair its owner and regenerate.
  3. Durable Codex-only body edits that should survive broader refactors belong in skills-codex-overrides/<name>/SKILL.md.
  4. Codex operator-layer prompt edits belong in skills-codex-overrides/<name>/prompt.md.

Audit First

Run:

bash scripts/audit-codex-parity.sh

Or target one skill:

bash scripts/audit-codex-parity.sh --skill swarm

The audit flags the failure classes that Codex maintenance keeps missing today:

  • Claude-era task primitives
  • Claude-only backend reference names and team terminology
  • duplicated runtime phrases created by blind search/replace

Repair Loop

For each flagged skill:

  1. Read skills/<name>/SKILL.md to confirm whether the canonical contract is correct.
  2. Read skills-codex/<name>/SKILL.md to see the broken checked-in Codex body.
  3. Read skills-codex-overrides/<name>/prompt.md and skills-codex-overrides/catalog.json.
  4. If the source contract is wrong, fix skills/<name>/SKILL.md first.
  5. If the shipped Codex artifact is wrong, repair canonical source or the owning generator, then run scripts/regen-all.sh. Do not hand-edit the projection.
  6. If the source is correct but Codex needs a durable tailoring layer, create or update skills-codex-overrides/<name>/SKILL.md.
  7. Re-run validation:
    • bash scripts/audit-codex-parity.sh
    • bash scripts/validate-codex-generated-artifacts.sh --scope worktree
    • bash scripts/validate-codex-override-coverage.sh

LLM Repair Guidance

When doing the actual rewrite, the LLM should:

  • preserve the behavior contract from skills/<name>/SKILL.md
  • remove Claude-only primitive/tool names from the Codex body
  • replace mechanical rewrites with real Codex-native instructions
  • keep durable Codex-only delta in skills-codex-overrides/<name>/SKILL.md when it should remain distinct from the checked-in artifact

If a skill keeps needing Codex-only body surgery, update skills-codex-overrides/catalog.json so the treatment matches reality instead of pretending the skill is still parity-only.

Source: SKILL.md on GitHub

Third-party checks

No alerts3d3 checks · Risk SAFE
  • Gen Agent Trust Hub3d

    The skill-builder is a robust developer tool for managing AI agent skill packages. It incorporates strong security practices, including clean-room verification to prevent indirect prompt injection, containment guards to prevent accidental file deletion, and safe parsing of YAML metadata.

  • Socket3d

    No alerts

  • Snyk3d

    Risk: LOW · No issues

Provenance

Signed by skilld at 860fce8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last week

README badge

README badge for boshu2/agentops/skill-builder