Skip to content

feat: improve skill scores for 5 core Rosetta skills#50

Open
rohan-tessl wants to merge 1 commit intogriddynamics:mainfrom
rohan-tessl:improve/skill-review-optimization
Open

feat: improve skill scores for 5 core Rosetta skills#50
rohan-tessl wants to merge 1 commit intogriddynamics:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl
Copy link
Copy Markdown

@rohan-tessl rohan-tessl commented Apr 8, 2026

Hey @isolomatov-gd 👋

I ran your skills through tessl skill review at work and found some targeted improvements.

image

Here's the full before/after:

Skill Before After Change
coding-agents-prompt-adaptation 10% 84% +74%
requirements-authoring 10% 87% +77%
requirements-use 10% 77% +67%
load-context 25% 68% +43%
reasoning 36% 65% +29%

This PR is intentionally scoped to 5 skills to keep it reviewable — more can be improved in follow-ups or via automated review on future PRs.

Note: The source skills live in instructions/r2/core/skills/ and are propagated to plugins/ via scripts/plugin_generator.py. All changes target the source files only — plugin copies will regenerate automatically on the next sync.

Changes summary

All 5 skills:

  • Fixed duplicate tags fields in YAML frontmatter (caused validation failures and 10% scores for 3 skills)
  • Ensured description uses quoted string format without XML-like tags
  • Removed generic <role> preamble sections (the agent doesn't need motivational framing)

coding-agents-prompt-adaptation:

  • Restructured into explicit 8-step numbered workflow (detect → read → load KB → identify → HITL → adapt → validate → deliver)
  • Consolidated best_practices into workflow steps to reduce redundancy
  • Compressed pitfalls into categorized single-line entries

requirements-authoring:

  • Added explicit 9-step numbered workflow replacing the scattered <authoring_flow> and <initialization> sections
  • Consolidated SRP/DRY/KISS/MECE rule sections into a single <core_principles> block
  • Merged <conflict_checks>, <gap_checks>, and <validation_rules> into a unified <validation_checklist>
  • Combined <resources> and <templates> (they listed the same assets)
  • Compressed <language_constructs> into a dense paragraph preserving all rules

requirements-use:

  • Added explicit 7-step numbered workflow integrating the <process> steps with HITL gates
  • Consolidated <requirement_usage_rules> and <ambiguity_and_conflict_rules> into the workflow and core_concepts
  • Merged <resources> and <templates> sections

load-context:

  • Expanded from 2 lines to a full skill with proper frontmatter (tags, license, metadata)
  • Added 5-step workflow with clear blocking prerequisite semantics
  • Added validation checklist and pitfalls section

reasoning:

  • Restructured 7D flow from flat bullet lists into an explicit numbered workflow
  • Made confidence feedback loop actionable: specific formula for weighted confidence, targeted retry of weakest sub-problem (not entire process)
  • Consolidated best_practices into the workflow and pitfalls

Honest disclosure — I work at @tesslio where we build tooling around skills like these. Not a pitch - just saw room for improvement and wanted to contribute.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at this Tessl guide and ask it to optimize your skill. Ping me - @rohan-tessl - if you hit any snags.

Thanks in advance 🙏

Hey @isolomatov-gd 👋

I ran your skills through `tessl skill review` at work and found some targeted improvements. Here's the full before/after:

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| coding-agents-prompt-adaptation | 10% | 84% | +74% |
| requirements-authoring | 10% | 87% | +77% |
| requirements-use | 10% | 77% | +67% |
| load-context | 25% | 68% | +43% |
| reasoning | 36% | 65% | +29% |

This PR is intentionally scoped to 5 skills to keep it reviewable — more can be improved in follow-ups or via automated review on future PRs.

Note: The source skills live in instructions/r2/core/skills/ and are propagated to plugins/ via scripts/plugin_generator.py. All changes target the source files only — plugin copies will regenerate automatically on the next sync.

Changes:
- Fixed duplicate tags fields in YAML frontmatter (caused validation failures)
- Ensured description uses quoted string format without XML-like tags
- Removed generic role preamble sections
- Added explicit numbered workflows to all 5 skills
- Consolidated redundant rule sections (SRP/DRY/KISS into core_principles)
- Merged overlapping validation/conflict/gap checks into unified checklists
- Expanded load-context from 2 lines to full skill with workflow
- Made reasoning confidence feedback loop actionable with weighted formula

Signed-off-by: rohan-tessl <[email protected]>
@rohan-tessl rohan-tessl marked this pull request as ready for review April 8, 2026 08:42
@omaiesh omaiesh requested a review from isolomatov-gd April 9, 2026 15:21
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