Skip to content

feat: improve bootstrapp skill score (56% → 94%)#1

Open
yogesh-tessl wants to merge 1 commit intoapparata:masterfrom
yogesh-tessl:improve/skill-review-optimization
Open

feat: improve bootstrapp skill score (56% → 94%)#1
yogesh-tessl wants to merge 1 commit intoapparata:masterfrom
yogesh-tessl:improve/skill-review-optimization

Conversation

@yogesh-tessl
Copy link
Copy Markdown

Hey 👋 @memfrag

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

score_card
Changes made
  • Expanded frontmatter description with a "Use when..." clause and natural trigger keywords (scaffold, create project from template, bootstrap a codebase, generate boilerplate) — description score jumped from 17% → 100%
  • Moved user-invocable from unknown frontmatter key to metadata block to resolve validation warning
  • Removed self-referential opening ("You are a skill that...") in favour of direct, third-person instruction
  • Replaced hardcoded user-specific path (/Users/martinjohannesson/...) with a configurable placeholder
  • Added error handling step (step 7) with concrete diagnostics: verify template path, check Swift build errors, validate regex constraints
  • Trimmed redundant notes (removed verbose template bundle explanation and duplicate content)

Honest disclosure — I work at https://github.com/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 - @yogesh-tessl (https://github.com/yogesh-tessl) - if you hit any snags.

Thanks in advance 🙏

Hey 👋 @memfrag

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 |
|-------|--------|-------|--------|
| bootstrapp | 56% | 94% | +38% |

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

- Expanded frontmatter description with a "Use when..." clause and natural trigger keywords (scaffold, create project from template, bootstrap a codebase, generate boilerplate) — description score jumped from 17% → 100%
- Moved user-invocable from unknown frontmatter key to metadata block to resolve validation warning
- Removed self-referential opening ("You are a skill that...") in favour of direct, third-person instruction
- Replaced hardcoded user-specific path (/Users/martinjohannesson/...) with a configurable <path-to-BootstrappKit> placeholder
- Added error handling step (step 7) with concrete diagnostics: verify template path, check Swift build errors, validate regex constraints
- Trimmed redundant notes (removed verbose template bundle explanation and duplicate 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 - @yogesh-tessl (https://github.com/yogesh-tessl) - if you hit any snags.

Thanks in advance 🙏
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