feat: add skill to author and maintain Compass manifests for agentic packs - #154
feat: add skill to author and maintain Compass manifests for agentic packs#154rhartuv wants to merge 4 commits into
Conversation
|
Note: |
|
True! Good Catch. I'm creating another task for solving this gap and assigning it to you. Good chance for testing the skill you're working on :) |
|
|
|
||
| Map **only** MCP servers a skill actually uses. Derive usage from `SKILL.md` `allowed-tools`, `Required MCP Servers`, and workflow MCP tool names — not from copying another skill's manifest. | ||
|
|
||
| ## Owned MCP servers (registered in `mcps/`) |
There was a problem hiding this comment.
isn't the list too restrictive? shouldn't we just provide instruction on how to derive the dependant MCPs w/o listing them?
| 1. Compare YAML against [assets/](assets/) and a known-good manifest in the same pack. | ||
| 2. Re-run drift audit (§3). | ||
| 3. Tier 1 on this skill if edited: `uv run python scripts/validate_skills_tier1.py .claude/skills/compass-manifest-maintenance/SKILL.md`. | ||
| 4. Post-merge: maintainer may register in Compass UI manually (out of scope for this skill). |
There was a problem hiding this comment.
isn't there any drift that we can prevent adding a CI validation script? (we already have many iof them in the scripts/ folder)
There was a problem hiding this comment.
Makes sense. I figured this was out of scope for this PR since it's just the skill and docs, but I can add a scripts/validate_compass_manifests.py script for it. Let me know if you'd rather I include it here or open a separate ticket.
Summary
Add
compass-manifest-maintenanceClaude skill to author and maintain Compasscatalog-info.yamlmanifests for agentic packs.mcps.jsonkeys → owned vs canonical Compass refs)CLAUDE.mdandagentic-contribution-skillAdd missing Compass manifest for
ocp-admin/skills/network-policy-architect, closing a pre-existing catalog gap identified during PR #154 review.catalog-info.yaml(AiResource,namespace: ai5-marketplace,type: skill)Test plan
uv run python scripts/validate_skills_tier1.py .claude/skills/compass-manifest-maintenance/SKILL.mdpassesrh-sre,rh-virt,rh-basic- no skills missing from Location targetsdependencyOf(+ MCP if applicable)make validatepassesCloses APPENG-6131
Closes APPENG-6002
Implements #151