Skip to content

chore: improve skill descriptions, add trigger evals, bump to 1.1.1#18

Closed
keepithuman wants to merge 6 commits intoitential:mainfrom
keepithuman:chore/skill-descriptions-evals-v1.1.1
Closed

chore: improve skill descriptions, add trigger evals, bump to 1.1.1#18
keepithuman wants to merge 6 commits intoitential:mainfrom
keepithuman:chore/skill-descriptions-evals-v1.1.1

Conversation

@keepithuman
Copy link
Copy Markdown
Contributor

Summary

  • Skill descriptions rewritten for spec-agent, solution-arch-agent, builder-agent, explore, documentation, and project-to-spec — all now lead with explicit trigger language and example phrases to reduce undertriggering
  • documentation vs project-to-spec boundary clarifieddocumentation handles global/bulk catalog only; project-to-spec handles named single projects. Each skill now points at the other for out-of-scope requests
  • README updates — added /documentation to How to Use It, added Demo Specs section with 4 demo spec links
  • Plugin version bumped to 1.1.1
  • Trigger evals addedevals/trigger-evals/ contains 20-query eval sets and results for 5 skills, reusable for future description optimization runs

Test plan

  • Verify skill descriptions load correctly after plugin update
  • Confirm documentation redirects to project-to-spec when a project name is provided
  • Confirm project-to-spec cross-reference to documentation is visible in skill body
  • Run /plugin update itential-builder@claude-plugins-official and verify version shows 1.1.1

🤖 Generated with Claude Code

… 1.1.1

- Rewrites descriptions for spec-agent, solution-arch-agent, builder-agent,
  explore, documentation, and project-to-spec with explicit trigger language
  and "Trigger it for phrases like..." examples to reduce undertriggering
- Clarifies documentation vs project-to-spec boundary: documentation handles
  global/bulk catalog only; project-to-spec handles named single projects
- Adds documentation skill redirect to project-to-spec when a project is named
- Adds /documentation example to README How to Use It section
- Adds Demo Specs section to README with 4 demo spec links
- Bumps plugin version to 1.1.1
- Adds evals/trigger-evals/ with 20-query eval sets and results for 5 skills

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@keepithuman keepithuman requested a review from a team as a code owner April 10, 2026 22:06
keepithuman and others added 5 commits April 10, 2026 18:09
Replaces the one-liner "re-authenticate using .env" with a full
step-by-step procedure covering 401/403 detection, credential lookup,
OAuth vs local auth endpoint, .auth.json update, and request retry.
Based on post-session feedback that the existing guidance was insufficient.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Assets added to a project get an @{projectId}: prefix — PUT calls
without it return 400. Applies to any skill that reads or updates
project-owned assets, not just builder-agent.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
adapter_id is required in incoming variables for all adapter tasks —
missing it causes "No config found for Adapter" at runtime.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
Adds lifecycle sequencing back to spec-agent, solution-arch-agent,
and builder-agent descriptions so Claude knows the correct order
and what each skill hands off to next.

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
@keepithuman keepithuman deleted the chore/skill-descriptions-evals-v1.1.1 branch April 10, 2026 22:17
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