agentskills-manifest

Exports SKILL.md frontmatter into an agentskills.io v1 manifest as agentskills.json and agentskills.yaml.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill agentskills-manifest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: agentskills-manifest
Source: https://github.com/CleanExpo/Pi-Dev-Ops/tree/main/skills/agentskills-manifest
Command: npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill agentskills-manifest

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual and error-prone work of keeping a coherent, machine-readable registry of Pi-CEO skills aligned with the agentskills.io v1 format for Hermes runtimes.

Core Features & Use Cases

  • Skill registry export: Walks Pi-Dev-Ops/skills/, normalizes every SKILL.md frontmatter into the agentskills.io v1 manifest schema, and generates a single agentskills.json plus agentskills.yaml at the repo root.
  • Topology-aware dependency extraction: Extracts tool and skill references from tables and topology patterns in SKILL.md, with best-effort inference and flags for low confidence.
  • Safety bindings annotation: Derives kill-switch, HITL gate, and PII handling attributes from Safety sections to support downstream policy checks during runtime onboarding.
  • Use case: Prepare a Hermes-compatible skill registry export so the same skill metadata can power a registry browser/search and make Hermes configuration switching a straightforward change.

Quick Start

Run python -m swarm.agentskills_manifest to generate agentskills.json and agentskills.yaml at the repository root.

Frequently Asked Questions about agentskills-manifest

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate an agentskills.io v1 manifest from a Pi skill registry?▼

To generate an agentskills.io v1 manifest, run python -m swarm.agentskills_manifest to deterministically traverse skills/, normalize SKILL.md frontmatter, and write agentskills.json and agentskills.yaml to the repository root.

What is the best way to automate CI freshness checks for a Hermes runtime skill registry?▼

Automating CI freshness checks involves running manifest generation after any skills/ changes to validate that Hermes runtime artifacts align with the latest SKILL.md metadata and prevent configuration drift.

How does manifest generation extract tool and skill dependencies from SKILL.md files?▼

Dependency extraction parses tables and topology patterns within SKILL.md bodies using best-effort inference to identify tool and skill references, explicitly flagging low-confidence matches for manual review.

Can I derive safety annotations like kill-switch and HITL gates during skill registry export?▼

Yes, skill registry export derives safety annotations by extracting kill-switch, HITL gate, and PII handling attributes from Safety sections to support downstream policy checks during runtime onboarding.

Does manifest generation require Hermes runtime dependencies to export skill metadata?▼

No, manifest generation operates with zero dependencies, requiring only a local skills/ directory containing SKILL.md files to produce the Hermes-compatible agentskills.json and agentskills.yaml artifacts.