Carlo1911
18df2fe7b4
Standalone Python stdlib pipeline that reads an agent's past sessions, compares them against installed skills, and generates structured improvement proposals gated by an evaluation framework before anything mutates. Host-agnostic via HostAdapter (Hermes, Claude Code). Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
120 lines
4.0 KiB
Python
120 lines
4.0 KiB
Python
#!/usr/bin/env python3
|
|
"""Scan ~/.hermes/skills/ and output a compact index.
|
|
|
|
Usage:
|
|
python skill_index.py # Full index as JSON
|
|
python skill_index.py --categories-only # Just category names
|
|
python skill_index.py --name "debugging" # Find specific skill
|
|
"""
|
|
|
|
import json
|
|
import os
|
|
import sys
|
|
from pathlib import Path
|
|
from typing import Optional
|
|
|
|
|
|
SKILLS_DIR = os.path.expanduser("~/.hermes/skills")
|
|
|
|
|
|
def parse_name_description_frontmatter(content: str) -> dict:
|
|
"""Extract name/description fields from a SKILL.md-style YAML frontmatter block.
|
|
|
|
Returns an empty (or partial) dict when frontmatter is missing or has no
|
|
closing delimiter -- callers decide whether that's an error.
|
|
"""
|
|
fields = {}
|
|
if not content.startswith("---"):
|
|
return fields
|
|
parts = content.split("---", 2)
|
|
if len(parts) < 3:
|
|
return fields
|
|
for line in parts[1].split("\n"):
|
|
line = line.strip()
|
|
if line.startswith("name:"):
|
|
fields["name"] = line.split(":", 1)[1].strip().strip("'\"")
|
|
elif line.startswith("description:"):
|
|
fields["description"] = line.split(":", 1)[1].strip().strip("'\"")
|
|
return fields
|
|
|
|
|
|
def build_skill_record(skill_md: Path, category: str) -> Optional[dict]:
|
|
"""Build one skill's index record from its SKILL.md path, or None if it can't be read.
|
|
|
|
Shared by scan_skills()'s category-nested walk (Hermes) and
|
|
host.ClaudeCodeAdapter.iter_skills()'s flat walk -- the record shape and the
|
|
fields-then-fallback-to-dirname logic are identical either way; only how `category`
|
|
is derived differs (a real directory level for Hermes, a constant for Claude Code).
|
|
"""
|
|
try:
|
|
content = skill_md.read_text(encoding="utf-8")
|
|
except OSError:
|
|
return None
|
|
fields = parse_name_description_frontmatter(content)
|
|
name = fields.get("name", skill_md.parent.name)
|
|
description = fields.get("description", "")
|
|
return {
|
|
"name": name,
|
|
"category": category,
|
|
"description": description,
|
|
"path": str(skill_md),
|
|
"size": len(content),
|
|
}
|
|
|
|
|
|
def scan_skills(skills_dir: str = SKILLS_DIR) -> list:
|
|
"""Scan skills directory and return structured index."""
|
|
base = Path(skills_dir)
|
|
if not base.exists():
|
|
return []
|
|
|
|
results = []
|
|
|
|
for category_dir in sorted(base.iterdir()):
|
|
if not category_dir.is_dir():
|
|
continue
|
|
|
|
# Dot-prefixed dirs are internal, not live skill categories: `.archive/` holds
|
|
# retired skills, `.curator_backups/` timestamped snapshots, `.hub/` lockfiles
|
|
# and quarantine. Indexing them would tell the analyzer a retired skill still
|
|
# exists, and an archived twin of a live skill would make optimize_skill.py's
|
|
# duplicate-name check reject the live one as ambiguous.
|
|
if category_dir.name.startswith("."):
|
|
continue
|
|
|
|
category = category_dir.name
|
|
|
|
for skill_dir in sorted(category_dir.iterdir()):
|
|
record = build_skill_record(skill_dir / "SKILL.md", category)
|
|
if record is not None:
|
|
results.append(record)
|
|
|
|
return results
|
|
|
|
|
|
def main():
|
|
import argparse
|
|
parser = argparse.ArgumentParser(description="Scan installed skills for the active host")
|
|
parser.add_argument("--categories-only", action="store_true")
|
|
parser.add_argument("--name", type=str, default=None)
|
|
args = parser.parse_args()
|
|
|
|
# host is imported locally: host.py imports this module (HermesAdapter delegates to
|
|
# scan_skills()), so a module-scope `import host` here would cycle.
|
|
import host as host_module
|
|
|
|
skills = host_module.get_adapter().iter_skills()
|
|
|
|
if args.name:
|
|
skills = [s for s in skills if args.name.lower() in s["name"].lower()]
|
|
|
|
if args.categories_only:
|
|
categories = sorted(set(s["category"] for s in skills))
|
|
print("\n".join(categories))
|
|
else:
|
|
print(json.dumps(skills, indent=2))
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|