How mark-groves/skills-nexus works
skills-nexus is a repository-owned foundry for portable agent-workflow plugins, with evaluation and quality contracts plus an evidence-based improvement loop. The main workflow is author or use a packaged skill, evaluate it against repository cases (with behavioral proof through the documented Cloud Agent path), then process execution observations and promote accepted evidence into regression cases. Separate capabilities include local harness deployment and draw.io shape-catalog/diagram support. The graph reflects README-documented links and sampled tool responsibilities; unsampled implementation wiring is intentionally omitted.
Main entry points: plugins Plugin bundles · cloud-diagram/SKILL.md Cloud diagram skill · drawio-shapes/SKILL.md Draw.io shapes skill · validate_repo.py Repository validation
Components 23
Portable plugins
- Plugin bundles
plugins - Git workflow
plugins/git-workflow/skills - Skill architect
plugins/skill-architect/skills/skill-architect/SKILL.md
Evaluation and learning
- Evaluation cases
scripts/eval_cases.py - Skill eval suites
evals - Behavioral proof
scripts/eval_evidence.py - Observation handling
scripts/skill_observation/core.py - Observation triage
scripts/skill_triage - Case promotion
scripts/skill_triage/promote.py
Repository contracts
- Skill deployment
scripts/deploy-skills.sh - Harness targets
harnesses - Plugin index
scripts/plugin_repository.py - Repository validation
scripts/validate_repo.py - Versioned contracts
schemas
Diagram tooling
- Cloud diagram skill
plugins/drawio/skills/cloud-diagram/SKILL.md - Draw.io shapes skill
plugins/drawio/skills/drawio-shapes/SKILL.md - Shape catalog
plugins/drawio/skills/cloud-diagram/scripts/shape_catalog.py - Diagram validation
plugins/drawio/skills/cloud-diagram/scripts/validate_diagram.py - Shape extraction
plugins/drawio/skills/drawio-shapes/scripts/extract.py - Catalog generation
plugins/drawio/skills/drawio-shapes/scripts/generate_catalog.py
Other components
- Skill author
- Agent harness
- Cloud Agent
Connections 28
- Skill author → Plugin bundles: authors skills
- Plugin bundles → Git workflow: includes
- Plugin bundles → Skill architect: includes
- Plugin bundles → Cloud diagram skill: includes
- Plugin bundles → Draw.io shapes skill: includes
- Agent harness → Git workflow: invokes
- Agent harness → Skill architect: invokes
- Agent harness → Cloud diagram skill: invokes
- Agent harness → Draw.io shapes skill: invokes
- Skill deployment → Plugin index: resolves bundles
- Skill deployment → Harness targets: targets
- Plugin index → Plugin bundles: indexes
- Repository validation → Plugin index: checks contract
- Repository validation → Skill eval suites: validates
- Repository validation → Harness targets: validates
- Evaluation cases → Skill eval suites: loads cases
- Cloud Agent → Behavioral proof: runs prove path
- Behavioral proof → Evaluation cases: uses cases
- Agent harness → Observation handling: execution evidence
- Observation handling → Observation triage: records evidence
- Observation triage → Case promotion: accepts evidence
- Case promotion → Skill eval suites: updates cases
- Observation handling → Versioned contracts: validates format
- Cloud diagram skill → Shape catalog: looks up shapes
- Cloud diagram skill → Diagram validation: validates diagrams
- Draw.io shapes skill → Shape extraction: extracts definitions
- Draw.io shapes skill → Catalog generation: generates catalogs
- Shape extraction → Catalog generation: provides shape data