Skip to content

Refactor creating-skills as skill-creator orchestrator - #29

Merged
ether-moon merged 2 commits into
mainfrom
ether_karrot/orchestrate-skill-creator
Jul 22, 2026
Merged

Refactor creating-skills as skill-creator orchestrator#29
ether-moon merged 2 commits into
mainfrom
ether_karrot/orchestrate-skill-creator

Conversation

@ether-moon

@ether-moon ether-moon commented Jul 22, 2026

Copy link
Copy Markdown
Owner

Summary

  • make creating-skills the primary entry point for new and existing skill work
  • delegate the complete supported authoring and evaluation loop to skill-creator while retaining project policy and final lifecycle decisions
  • preserve portable fallback behavior and project-specific evaluation insights without duplicating creator-owned guidance

Changes

  • refactor the main skill and references around an explicit orchestration contract
  • strengthen creator-present functional evals and generated trigger cases to require delegation before artifact edits
  • add regression coverage for entry-point priority, delegation ownership, lifecycle policy, host portability, and valid name preservation
  • update generated inventory descriptions in README.md and AGENTS.md

Test Plan

  • bash plugins/skill-set/tests/run.sh

Summary by CodeRabbit

  • Documentation

    • Updated creating-skills guidance to establish it as the primary orchestration entry point for skill creation, evaluation, governance, and acceptance.
    • Added clearer policies for delegation, validation, testing, portability, evidence, lifecycle maintenance, and fallback workflows.
  • Tests

    • Expanded evaluation coverage to verify delegation, ordering, policy gates, final acceptance ownership, validation, isolation, and cross-host behavior.
    • Added checks for creator-present and creator-unavailable workflows.

@coderabbitai

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown

Review Change Stack

Warning

Review limit reached

@ether-moon, you've reached your PR review limit, so we couldn't start this review.

Next review available in: 32 minutes

Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available.
You're only billed for reviews past your plan's rate limits ($0.25/file).

How can I continue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews.

How do review limits work?

CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability.

For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window.

Please refer docs for additional details.

Review details
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 17b4a5cc-7c65-4c46-91c7-af1fea4b81ba

📥 Commits

Reviewing files that changed from the base of the PR and between 1e7e17e and 52b8aa9.

📒 Files selected for processing (9)
  • AGENTS.md
  • README.md
  • plugins/skill-set/evals/creating-skills/new-with-creator/case.yaml
  • plugins/skill-set/evals/creating-skills/new-with-creator/fixtures/scaffold.sh
  • plugins/skill-set/evals/creating-skills/new-with-creator/prompt.md
  • plugins/skill-set/skills/creating-skills/SKILL.md
  • plugins/skill-set/skills/creating-skills/reference/checklist.md
  • plugins/skill-set/skills/creating-skills/reference/evaluation.md
  • plugins/skill-set/skills/creating-skills/reference/troubleshooting.md
📝 Walkthrough

Walkthrough

The PR makes creating-skills the primary orchestration entry point, delegates supported authoring and evaluation work to skill-creator, adds local fallback and policy-gate rules, rewrites reference policies, and updates creator-present fixtures and trigger evaluations.

Changes

Creating-skills orchestration

Layer / File(s) Summary
Orchestration contract and portable skill structure
AGENTS.md, README.md, plugins/skill-set/skills/creating-skills/SKILL.md, plugins/skill-set/skills/creating-skills/reference/{checklist,structure}.md
creating-skills now owns orchestration contracts, evidence review, acceptance decisions, portable layout translation, delegation boundaries, fallback execution, and handoff validation.
Evaluation, testing, and maintenance policy
plugins/skill-set/skills/creating-skills/reference/{evaluation,testing,troubleshooting,patterns}.md, plugins/skill-set/skills/creating-skills/reference/checklist.md
References define four evaluation dimensions, isolated trials, cross-host checks, behavioral contracts, unavailable metrics, failure classification, regression promotion, and retirement review.
Creator-present delegation fixtures
plugins/skill-set/evals/creating-skills/{new-with-creator,existing-with-creator}/**
Fixtures and graders require consulting optional-creator/SKILL.md before writing or editing, delegating artifact-producing work, validating results, and retaining final acceptance with creating-skills.
Trigger criteria and authoring regression coverage
plugins/skill-set/evals/creating-skills/trigger-positive-*/case.yaml, plugins/skill-set/evals/trigger-cases.json, plugins/skill-set/scripts/generate-trigger-evals, plugins/skill-set/tests/test-authoring-skills.sh
Trigger graders and shell assertions now check primary entry-point selection, conditional creator delegation, local fallback, policy preservation, and final lifecycle decisions.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant Request
  participant creating-skills
  participant skill-creator
  participant Validator
  participant PolicyGate
  Request->>creating-skills: request skill creation or revision
  creating-skills->>skill-creator: delegate supported authoring and evaluation preparation
  skill-creator-->>creating-skills: return artifacts and evaluation evidence
  creating-skills->>Validator: validate project artifacts
  Validator-->>creating-skills: return validation results
  creating-skills->>PolicyGate: inspect evidence and apply thresholds
  PolicyGate-->>creating-skills: accept, reject, or require correction
Loading

Possibly related PRs

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: refactoring creating-skills to orchestrate work through skill-creator.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch ether_karrot/orchestrate-skill-creator

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Actionable comments posted: 9

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@plugins/skill-set/evals/creating-skills/existing-with-creator/case.yaml`:
- Around line 49-55: Broaden the tool-order checks in
plugins/skill-set/evals/creating-skills/existing-with-creator/case.yaml lines
49-55 by adding an explicit creator invocation prerequisite and covering both
Edit and Write operations; in
plugins/skill-set/evals/creating-skills/new-with-creator/case.yaml lines 45-51,
add the creator invocation check, require creating-skills before delegated work,
and cover both Write and Edit operations. Preserve the existing Read
prerequisites while adding these additional order constraints.

In `@plugins/skill-set/evals/creating-skills/new-with-creator/prompt.md`:
- Line 1: Require the generated incident-triage SKILL.md frontmatter description
to explicitly state the post-incident status-summary exclusion, rather than
allowing that boundary only in the body. Update the evaluation case to assert
this negative boundary within the description field, and adjust scaffold.sh
validation to inspect the description specifically instead of the entire file
while preserving the active-triage trigger requirement.

In `@plugins/skill-set/evals/creating-skills/trigger-positive-01/case.yaml`:
- Line 22: Update the graders for the creating-skills positive case to verify
that skill-creator is actually invoked, not merely claimed in last_message. Add
coverage that observes the skill-creator tool call and, where relevant, its
ordering after creating-skills selection, while preserving the existing checks
for primary entry-point selection and lifecycle behavior.

In `@plugins/skill-set/skills/creating-skills/reference/checklist.md`:
- Around line 34-35: Update the checklist items for nondeterministic trials and
supported model-tier evaluation so they are required only when an evaluation
adapter is available. For unavailable adapters, require deterministic validation
and runnable cases to remain complete, and require honest reporting that model
evaluation was unavailable, preserving the same policy-gate outcome without
falsely marking model-dependent criteria complete.

In `@plugins/skill-set/skills/creating-skills/reference/evaluation.md`:
- Around line 74-84: Update the acceptance and retirement guidance to cover
every declared evaluation dimension: in
plugins/skill-set/skills/creating-skills/reference/evaluation.md lines 74-84,
require explicit outcome, conformance, safety, and efficiency thresholds, with
zero safety violations as a hard gate; in
plugins/skill-set/skills/creating-skills/reference/troubleshooting.md lines
43-45, include conformance in the no-skill retirement comparison.

In `@plugins/skill-set/skills/creating-skills/SKILL.md`:
- Line 3: Rewrite the frontmatter description in SKILL.md to use third-person
phrasing, replacing the noun fragment and imperative “Use” with wording such as
“This skill is the primary entry point…”. Preserve the existing creation,
modification, evaluation, lifecycle-governance trigger scope and skill-creator
delegation guidance.
- Line 8: Update the workflow phase headings in SKILL.md to use numbered `### N.
Phase` formatting consistently, including the headings at all referenced
locations. Preserve non-phase sections such as References at their existing
heading level.
- Around line 37-54: Update the “Delegate the Execution Loop” and “Apply the
Policy Gate” guidance to require explicit human confirmation before destructive,
irreversible, publication, or retirement actions. Tie the checkpoint to the
declared authority and mutation boundaries, while allowing routine low-risk
edits to proceed under existing authorization.

In `@plugins/skill-set/tests/test-authoring-skills.sh`:
- Around line 98-107: Update the creator-present assertions in the test loop
over new-with-creator and existing-with-creator so they require an affirmative,
mandatory handoff to skill-creator rather than merely matching “delegate.” Also
verify that the skill-creator definition is read before any artifact edits,
either through prompt/lifecycle assertions that enforce this ordering or by
checking the actual tool-call order.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b2cf9f0b-16fc-4cc7-8a25-ab9b3bb6eea5

📥 Commits

Reviewing files that changed from the base of the PR and between 224d840 and 1e7e17e.

📒 Files selected for processing (28)
  • AGENTS.md
  • README.md
  • plugins/skill-set/evals/creating-skills/existing-with-creator/case.yaml
  • plugins/skill-set/evals/creating-skills/existing-with-creator/fixtures/scaffold.sh
  • plugins/skill-set/evals/creating-skills/existing-with-creator/graders/lifecycle.md
  • plugins/skill-set/evals/creating-skills/existing-with-creator/prompt.md
  • plugins/skill-set/evals/creating-skills/new-with-creator/case.yaml
  • plugins/skill-set/evals/creating-skills/new-with-creator/fixtures/scaffold.sh
  • plugins/skill-set/evals/creating-skills/new-with-creator/graders/lifecycle.md
  • plugins/skill-set/evals/creating-skills/new-with-creator/prompt.md
  • plugins/skill-set/evals/creating-skills/trigger-positive-01/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-02/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-03/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-04/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-05/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-06/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-07/case.yaml
  • plugins/skill-set/evals/creating-skills/trigger-positive-08/case.yaml
  • plugins/skill-set/evals/trigger-cases.json
  • plugins/skill-set/scripts/generate-trigger-evals
  • plugins/skill-set/skills/creating-skills/SKILL.md
  • plugins/skill-set/skills/creating-skills/reference/checklist.md
  • plugins/skill-set/skills/creating-skills/reference/evaluation.md
  • plugins/skill-set/skills/creating-skills/reference/patterns.md
  • plugins/skill-set/skills/creating-skills/reference/structure.md
  • plugins/skill-set/skills/creating-skills/reference/testing.md
  • plugins/skill-set/skills/creating-skills/reference/troubleshooting.md
  • plugins/skill-set/tests/test-authoring-skills.sh

Comment thread plugins/skill-set/evals/creating-skills/new-with-creator/prompt.md Outdated
Comment thread plugins/skill-set/skills/creating-skills/reference/checklist.md Outdated
Comment thread plugins/skill-set/skills/creating-skills/reference/evaluation.md
Comment thread plugins/skill-set/skills/creating-skills/SKILL.md Outdated
Comment thread plugins/skill-set/skills/creating-skills/SKILL.md
Comment thread plugins/skill-set/skills/creating-skills/SKILL.md
Comment thread plugins/skill-set/tests/test-authoring-skills.sh
@ether-moon

Copy link
Copy Markdown
Owner Author

@coderabbitai resolve

검토 의견 9개를 모두 처리했습니다. 객관적으로 검증 가능한 4개 항목은 반영했고, 실행 경로를 불필요하게 강제하거나 평가·권한 정책 선택이 필요한 5개 제안은 현재 동작을 유지했습니다. description 경계 검증, 평가 adapter 조건부 기준, 네 평가 차원의 acceptance/retirement 일관성, third-person catalog description을 개선했으며 전체 테스트가 통과했습니다.

@coderabbitai

coderabbitai Bot commented Jul 22, 2026

Copy link
Copy Markdown

@ether-moon 검토 및 설명 감사합니다. 반영 사항과 의도적으로 유지한 정책적 선택을 확인했습니다. 리뷰 의견을 해결 처리하겠습니다.

✅ Action performed

Comments resolved. Approval is disabled; enable reviews.request_changes_workflow to allow explicit top-level @coderabbitai resolve or @coderabbitai approve commands.

@ether-moon
ether-moon merged commit dbf6607 into main Jul 22, 2026
2 checks passed
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.

1 participant