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.