Skip to content

publish-skill-to-skillfolio

skillLast commit

Agent skill for adding verified Codex and Claude Code skills to Skillfolio catalogs with schema, README, sitemap, and build validation.

Open productSource
Role
Agent workflow design and automation engineering
Scope
Agent workflow, validation automation, and packaging
Status
Published npm package

Problem

Adding a skill to a catalog touches duplicated consumers and can import stale package/repository facts or mistake "publish" for permission to deploy.

Constraints

  1. C1

    Catalog schemas and consumers vary by target app.

  2. C2

    Repository/package/version/compatibility facts require primary-source verification.

  3. C3

    Local catalog editing does not authorize commit, push, npm publication, pull requests, or deployment.

Architecture

Source identity/evidence resolution; target-app schema and consumer tracing; Python entry validator plus repository-native format/type/test/build/sitemap gates.

01

Skill workflow

Source identity/evidence resolution.

02

Automation

Target-app schema and consumer tracing.

03

Verification

Python entry validator plus repository-native format/type/test/build/sitemap gates.

Decisions

D1

Discover the live catalog schema

Discover the live catalog schema instead of assuming one.

D2

Update exactly one entry and trace all existing consumers

Update exactly one entry and trace all existing consumers.

D3

Pair the heuristic validator with the app's own checks

Pair the heuristic validator with the app's own checks because JSON shape alone cannot prove presentation or routing.

Contribution

  • Defined evidence and authorization rules.
  • Built schema/consumer discovery workflow.
  • Implemented deterministic catalog-entry validation.
  • Integrated README index, sitemap, type-check, test, and production-build acceptance gates.

Outcomes

  • Agents can resolve a canonical skill identity.
  • Add/update a valid entry.
  • Keep indexes and sitemap aligned.
  • Report local completion without implying external publication.

Verified stack

  • Agent Skills
  • JavaScript
  • Python
  • Node.js
  • npm
  • GitHub Actions
  • CI/CD

Working through something similar?

Share your challenge, scope, and timeline to start a focused conversation.