Skip to content

feat: bootstrap orchestrate skills for self-sufficient orchestration#22

Open
pdettori wants to merge 1 commit intomainfrom
orchestrate/replicate
Open

feat: bootstrap orchestrate skills for self-sufficient orchestration#22
pdettori wants to merge 1 commit intomainfrom
orchestrate/replicate

Conversation

@pdettori
Copy link
Contributor

Summary

Phase 6 (final) of repo orchestration — makes agentic-control-plane self-sufficient.

Copies the full orchestrate skill suite into .claude/skills/ so this repo can orchestrate its own related repositories without depending on the parent hub at runtime.

Skills added

Skill Purpose
orchestrate Router — /orchestrate <repo-url> entry point
orchestrate:scan Assess tech stack, CI maturity, and gaps
orchestrate:plan Create phased enhancement plans
orchestrate:precommit Add pre-commit hooks and quality baseline
orchestrate:tests Add test infrastructure and initial coverage
orchestrate:ci Add CI workflows (lint, test, build, security, dependabot)
orchestrate:security Add security governance files
orchestrate:replicate Self-replicating — propagate skills further
skills:scan Discover and audit skills in any repo
skills:write Author new skills
skills:validate Validate skill structure and frontmatter

Adaptations made

  • Removed two kagenti/kagenti-specific references in orchestrate:ci (gold standard description and SHA reference); skills are now repo-agnostic
  • All name: frontmatter fields verified to match their directory names (11/11 ✅)

CLAUDE.md

Added ## Claude Code Skills and ## Orchestration sections listing all available skills.

Test plan

  • Invoke /orchestrate <some-repo-url> from within this repo — it should route through scan → plan → phases without referencing kagenti/kagenti
  • Each skill frontmatter name: matches its directory name
  • No remaining source-specific references block general use

Copies the full orchestrate skill suite from the hub into this repo so
agentic-control-plane can orchestrate its own related repositories
without a runtime dependency on the parent hub.

Skills added:
- orchestrate        — router entry point
- orchestrate:scan   — assess repo tech stack and CI gaps
- orchestrate:plan   — create phased enhancement plans
- orchestrate:precommit — add pre-commit hooks and quality baseline
- orchestrate:tests  — add test infrastructure
- orchestrate:ci     — add CI workflows (lint, test, security, dependabot)
- orchestrate:security — add security governance files
- orchestrate:replicate — self-replicating (this skill)
- skills:scan        — discover and audit skills in a repo
- skills:write       — author new skills
- skills:validate    — validate skill structure and frontmatter

Adaptations:
- Removed two kagenti/kagenti-specific references in orchestrate:ci
  (gold standard description and SHA lookup reference)
- All frontmatter name: fields verified to match their directory names

CLAUDE.md updated with orchestration skill table.

Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com>
Signed-off-by: Paolo Dettori <dettori@us.ibm.com>
Copilot AI review requested due to automatic review settings March 13, 2026 12:35
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This pull request adds comprehensive documentation for Claude Code skills, including an orchestration system for enhancing target repositories through phased PRs. The changes consist of a CLAUDE.md update documenting available skills and six new skill documentation files that define a complete workflow ecosystem for scanning, writing, validating, and orchestrating improvements to codebases.

Changes:

  • Update CLAUDE.md to document Claude Code Skills and Orchestration sections with skill tables
  • Add skills:write skill documentation with comprehensive guidance on skill creation and conventions
  • Add skills:validate skill documentation for validating skill format compliance
  • Add skills:scan skill documentation for auditing and bootstrapping skills in repositories
  • Add orchestrate parent skill and phase-specific skills (scan, plan, precommit, tests, ci, security, replicate) totaling 1,658 lines

Reviewed changes

Copilot reviewed 12 out of 12 changed files in this pull request and generated 8 comments.

Show a summary per file
File Description
CLAUDE.md Documents two new sections: Claude Code Skills (basic skills) and Orchestration (orchestrate skills for enhancing other repos)
.claude/skills/skills:write/SKILL.md Comprehensive guide for creating and editing skills with proper structure, naming conventions, and task tracking standards
.claude/skills/skills:validate/SKILL.md Validation checklist and procedures for ensuring skills meet format and naming standards
.claude/skills/skills:scan/SKILL.md Comprehensive repository scanning guide for bootstrapping or auditing skills in target repositories
.claude/skills/orchestrate/SKILL.md Parent router skill explaining the orchestration workflow across seven phases
.claude/skills/orchestrate:* (5 files) Phase-specific skills (scan, plan, precommit, tests, ci, security, replicate) implementing the orchestration system

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants