update-skillfolio-catalog

skill

Adds or updates one verified Agent Skill in an explicitly identified local Skillfolio catalog.

Role: Agent workflow design and automation engineering
Scope: Agent workflow, validation automation, and packaging
Status: Published npm package v0.1.0

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

C1
Catalog schemas and consumers vary by target app.
C2
Repository/package/version/compatibility facts require primary-source verification.
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.

Skill workflow

Source identity/evidence resolution.

Automation

Target-app schema and consumer tracing.

Verification

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

Decisions

Discover the live catalog schema

Discover the live catalog schema instead of assuming one.

Update exactly one entry and trace all existing consumers

Update exactly one entry and trace all existing consumers.

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

Working through something similar?

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

Discuss a project