Skip to content

feat: improve skill review score from 17% to 89%#52

Open
popey wants to merge 1 commit intoblader:mainfrom
popey:improve/skill-review-optimization
Open

feat: improve skill review score from 17% to 89%#52
popey wants to merge 1 commit intoblader:mainfrom
popey:improve/skill-review-optimization

Conversation

@popey
Copy link

@popey popey commented Mar 9, 2026

@blader Hullo 👋

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

score_card

Here's the before/after in text form:

Skill Before After Change
humanizer 17% 89% +72%
Changes made
  • Fixed allowed-tools format: converted from a YAML list (object) to a space-delimited string, which was the only validation error blocking the LLM judge from scoring the skill
  • Added Quick-Reference Checklist: a scannable table near the top listing all 24 patterns with their key trigger words, so the agent can do a fast pass before diving into detailed sections
  • Condensed the full example: merged the intermediate "Draft rewrite" and "What makes this AI generated?" steps into a single "Final rewrite" output, since they were duplicative of the process and individual pattern examples already described
  • Tidied "Changes made" label to "Patterns removed" for clarity
  • Fixed curly quote rendering in pattern feat: modular skill fragments and humanizer-pro variant #18 example

No patterns, instructions, or capabilities were removed.

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.

If you want to run reviews, evals and optimizations yourself, just npm install @tessl/cli then run tessl skill review path/to/your/SKILL.md, and click here to find out more.

Thanks in advance 🙏

@blader Hullo 👋

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

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| humanizer | 17% | 89% | +72% |

<details>
<summary>Changes made</summary>

- **Fixed `allowed-tools` format**: converted from a YAML list (object) to a space-delimited string, which was the only validation error blocking the LLM judge from scoring the skill
- **Added Quick-Reference Checklist**: a scannable table near the top listing all 24 patterns with their key trigger words, so the agent can do a fast pass before diving into detailed sections
- **Condensed the full example**: merged the intermediate "Draft rewrite" and "What makes this AI generated?" steps into a single "Final rewrite" output, since they were duplicative of the process and individual pattern examples already described
- **Tidied "Changes made" label** to "Patterns removed" for clarity
- **Fixed curly quote rendering** in pattern blader#18 example

No patterns, instructions, or capabilities were removed.

</details>

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.

If you want to run reviews, evals and optimizations yourself, just `npm install @tessl/cli` then run `tessl skill review path/to/your/SKILL.md`, and click [here](https://tessl.io/registry/skills/submit) to find out more.

Thanks in advance 🙏
Comment on lines +330 to +333
**Problem:** ChatGPT uses curly quotes ("...") instead of straight quotes ("...").

**Before:**
> He said the project is on track but others disagreed.
> He said "the project is on track" but others disagreed.

Choose a reason for hiding this comment

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

This change breaks the sample of "what is to avoid"

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.

2 participants