Skip to content

feat: improve nuxt-users skill score to 100%#192

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

feat: improve nuxt-users skill score to 100%#192
rohan-tessl wants to merge 1 commit into
rrd108:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl
Copy link
Copy Markdown

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

Hey @offgrid-ing 👋

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

image
Skill Before After Change
arpc 80% 93% +13%

This PR optimizes the single SKILL.md in the repo — covering all skills present.

Changes summary
  • Expanded frontmatter description with an explicit "Use when..." clause and natural trigger terms (talk to another agent, inter-agent messages, agent-to-agent communication, message another AI) — description score jumped from 68% to 100%
  • Trimmed OpenClaw webhook section — removed redundant "How it works" step-by-step and legacy TCP bridge note that added tokens for a deprecated feature
  • Condensed receiving messages section — reduced three inbound message examples to one representative example
  • Added validation checkpointarpc doctor confirmation after webhook configuration
  • Quoted frontmatter description to standard format

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 @rrd108 👋

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 |
|-------|--------|-------|--------|
| nuxt-users | 94% | 100% | +6% |

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

- **Removed redundant "When to use this skill" section** — the YAML description already covers trigger terms comprehensively, so this section was duplicating context without adding value
- **Consolidated CLI fallback explanation** — the `loadNuxt` / `DB_*` fallback behavior was repeated across three sections (config reference, CLI commands, edge cases); consolidated into a single production note in the CLI section
- **Replaced verbose edge cases with a troubleshooting table** — swapped the 6-item numbered list for a compact symptom/fix table, removing entries that restated earlier config guidance (password validation, Google OAuth)
- **Trimmed unnecessary explanatory phrases** — removed padding like "This skill helps you work with..." (redundant with description), "required for protected routes" (evident from context), and "if needed for older setups"
- **Reduced line count from 165 → 141** while preserving all actionable content

</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.

Want to self-improve your skills? Just point your agent (Claude Code, Codex, etc.) at [this Tessl guide](https://docs.tessl.io/evaluate/optimize-a-skill-using-best-practices) and ask it to optimize your skill. Ping me - [@rohan-tessl](https://github.com/rohan-tessl) - if you hit any snags.

Thanks in advance 🙏
@rohan-tessl rohan-tessl marked this pull request as ready for review April 16, 2026 07:16
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