Skip to content

Bootstrap orchestrate and skills management skills#164

Merged
pdettori merged 2 commits intomainfrom
orchestrate/replicate
Mar 12, 2026
Merged

Bootstrap orchestrate and skills management skills#164
pdettori merged 2 commits intomainfrom
orchestrate/replicate

Conversation

@pdettori
Copy link
Contributor

Summary

Phase 6 of repository orchestration. Makes agent-examples self-sufficient for orchestrating other repos.

13 skills added (9 orchestrate + 4 skills management):

Category Skills
Orchestrate orchestrate (router), scan, plan, precommit, tests, ci, security, replicate, review
Skills skills (router), scan, write, validate

All skills adapted for standalone use:

  • Removed kagenti-specific references and hub-specific language
  • Removed references to non-copied skills (tdd:ci, rca:ci, cve:*, etc.)
  • Updated Related Skills to only reference available skills
  • Generalized command patterns and category lists

Also:

  • Updated CLAUDE.md with orchestration section
  • Added .repos/ to .gitignore

The fractal concept

With these skills, agent-examples can now orchestrate other repos through the same phased approach: scan → plan → precommit → tests → ci → security → replicate.

Test plan

  • Verify all 13 skill frontmatter names match directory names
  • Verify no broken skill cross-references remain
  • Verify no kagenti-specific paths or assumptions remain
  • Test /orchestrate status works from agent-examples context

Copy link
Contributor Author

@pdettori pdettori left a comment

Choose a reason for hiding this comment

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

Orchestration review: LGTM

Replicate phase reviewed. 13 skills bootstrapped with clean adaptation. All frontmatter valid, no broken cross-references, no kagenti-specific content remaining.

Fix applied: Generalized example commands and org-specific workflow reference (7f0bf2b).

Copy link
Contributor

@mrsabath mrsabath left a comment

Choose a reason for hiding this comment

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

Review Summary

Well-structured Phase 6 replication that bootstraps 13 orchestration and skills management skills into agent-examples. All skill files have proper YAML frontmatter with matching names, consistent structure (mermaid diagrams, When to Use, Related Skills), and no broken cross-references.

Areas reviewed: Skills structure, cross-references, kagenti-specific content, security
Commits: 2 commits, both signed-off ✓, Assisted-By ✓
CI status: all passing ✓

Findings:

  1. /tmp/kagenti/ hardcoded paths (suggestion): The temp directory pattern /tmp/kagenti/orchestrate/ and /tmp/kagenti/skills-scan/ appears in ~14 locations across the skill files. Since these are now in agent-examples (not kagenti), consider renaming to /tmp/orchestrate/ or parameterizing in a follow-up. Functional as-is.

  2. Minor kagenti references (nit):

    • skills:validate task example uses kagenti as worktree name
    • orchestrate:scan uses test_keycloak.py as illustrative example
  3. Skill length (nit): orchestrate:scan (488 lines) and orchestrate:ci (401 lines) exceed the 300-line recommended max from skills:validate. Could split in future.

No issues found with:

  • Skill cross-references (all 13 skills reference only valid siblings)
  • Security (no secrets, tokens, or credentials)
  • Frontmatter validity and naming consistency
  • Commit conventions and sign-off

LGTM — clean adaptation with the fractal orchestration concept intact.

Replicate Phase 6: copy orchestrate skills into agent-examples, making it
self-sufficient for orchestrating its own related repos.

Skills added:
- orchestrate (router) + scan, plan, precommit, tests, ci, security, replicate, review
- skills (router) + scan, write, validate

All skills adapted for standalone use:
- Removed kagenti-specific references and hub-specific language
- Removed references to non-copied skills (tdd:ci, rca:ci, cve:*, etc.)
- Updated Related Skills sections to only reference available skills
- Generalized command patterns and category lists

Also updates CLAUDE.md with orchestration section and .gitignore with .repos/ pattern.

Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com>
Signed-off-by: Paolo Dettori <dettori@us.ibm.com>
Replace kagenti-system/mlflow examples with generic my-namespace/my-app
in skills:validate and skills:write. Replace kagenti org reusable
workflow reference with generic <org> placeholder in orchestrate:ci.

Assisted-By: Claude (Anthropic AI) <noreply@anthropic.com>
Signed-off-by: Paolo Dettori <dettori@us.ibm.com>
@pdettori pdettori force-pushed the orchestrate/replicate branch from 7f0bf2b to c6b4da7 Compare March 12, 2026 20:13
@pdettori pdettori requested a review from a team as a code owner March 12, 2026 20:13
@pdettori pdettori merged commit 14919d2 into main Mar 12, 2026
10 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants