Skip to content

feat: improve skill scores and add Tessl review workflow#1

Open
rohan-tessl wants to merge 2 commits into
devsforge:mainfrom
rohan-tessl:improve/skill-review-optimization
Open

feat: improve skill scores and add Tessl review workflow#1
rohan-tessl wants to merge 2 commits into
devsforge:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl

@rohan-tessl rohan-tessl commented Mar 26, 2026

Copy link
Copy Markdown

Hey @devsforge 👋

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
project-planning 59% 94% +35%
testing-strategies 62% 90% +28%
backend-patterns 65% 90% +25%
frontend-patterns 65% 90% +25%
quality-gates 71% 100% +29%

This PR intentionally caps changes at five skills to keep it reviewable. The included GitHub Action workflow (see below) will surface Tessl feedback on future SKILL.md changes so the rest of the library can improve incrementally.

What changed

Descriptions (all 5 skills):

  • Replaced generic "expert knowledge in..." phrasing with concrete actions (e.g., "Designs RESTful API endpoints, implements JWT authentication...")
  • Added specific trigger terms users would naturally say (e.g., "PRD", "mocks", "coverage", ".tsx files")
  • Added explicit "Use when..." clauses with multiple trigger scenarios

project-planning (59% → 94%):

  • Added a 6-step workflow with validation checkpoint
  • Removed textbook explanations of MoSCoW, story points (Claude already knows these)
  • Kept actionable templates and estimation tables

testing-strategies (62% → 90%):

  • Added a decision table for choosing test type by scenario
  • Removed ASCII testing pyramid and coverage goals table
  • Streamlined code examples while keeping all patterns

backend-patterns (65% → 90%):

  • Added numbered JWT flow steps for workflow clarity
  • Tightened response format interfaces
  • Kept all executable code examples

frontend-patterns (65% → 90%):

  • Added pattern selection guide table at the top
  • Streamlined Zustand and TanStack Query examples
  • Kept compound components, hooks, HOC, and accessibility patterns

quality-gates (71% → 100%):

  • Restructured into clear gate progression (1→4)
  • Added failure recovery table with auto-fix and manual steps
  • Consolidated quality thresholds into a single reference table

Tessl Skill Review GitHub Action

This PR also adds .github/workflows/skill-review.yml — a lightweight workflow that automatically reviews SKILL.md files on future PRs:

  • What runs: On PRs that change **/SKILL.md, the workflow runs tesslio/skill-review and posts one comment with Tessl scores and feedback (updated on new pushes).
  • Zero extra accounts: Contributors do not need a Tessl login — only the default GITHUB_TOKEN is used to post the comment.
  • Non-blocking by default: The check is feedback-only — no surprise red CI. Add with: fail-threshold: 70 later if you want a hard gate.
  • Not a build replacement: This is review automation for skill markdown only — it doesn't replace your own build or compile pipelines.
  • Why only five skills here: Keeps this PR small and reviewable. After merge, every PR touching SKILL.md gets automatic review comments, so the rest of the library improves incrementally.

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 🙏

Optimized descriptions with concrete actions, specific trigger terms,
and explicit "Use when" clauses. Improved content with workflow guidance,
pattern selection tables, and failure recovery steps.

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| project-planning | 59% | 94% | +35% |
| testing-strategies | 62% | 90% | +28% |
| backend-patterns | 65% | 90% | +25% |
| frontend-patterns | 65% | 90% | +25% |
| quality-gates | 71% | 100% | +29% |
Hey @devsforge 👋

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 |
|-------|--------|-------|--------|
| project-planning | 59% | 94% | +35% |
| testing-strategies | 62% | 90% | +28% |
| backend-patterns | 65% | 90% | +25% |
| frontend-patterns | 65% | 90% | +25% |
| quality-gates | 71% | 100% | +29% |

This PR also adds .github/workflows/skill-review.yml so future PRs
that touch SKILL.md get automatic Tessl review feedback as a PR comment.
@rohan-tessl rohan-tessl marked this pull request as ready for review March 30, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

1 participant