Skip to content

feat: improve build-list skill score 72% → 90%#7

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

feat: improve build-list skill score 72% → 90%#7
yogesh-tessl wants to merge 1 commit into
Zoominfo:mainfrom
yogesh-tessl:improve/skill-review-optimization

Conversation

@yogesh-tessl
Copy link
Copy Markdown

Hey @admjs 👋

now that's truly impressive. 9 skills that map directly to the sales research workflow, from account research through to buying committee analysis. The meeting-prep and recommend-contacts skills especially stand out as things reps would actually reach for before a call.

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

Skill Before After Change
build-list 72% 90% +18%

I focused on build-list since it had the most improvement headroom and is a core capability of the plugin, building targeted prospect lists is what most users reach for first.

Changes made to build-list
  • Added "Use when..." clause to the description with natural trigger terms (prospect list, generate leads, find people, sales outreach list) - helps Claude reliably select the skill
  • Added concrete MCP tool call examples for lookup and search_contacts with real parameter syntax, so the agent knows exact invocation patterns
  • Added validation checkpoints - lookup failure handling (suggest alternative terms) and zero-result fallback (auto-broaden filters with user notification)
  • Trimmed input examples from 5 to 3 representative cases to reduce token overhead
  • Condensed output format - removed empty table placeholders and tightened the refinement options section

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

if you want to self-improve your skills, or define your own scenarios to pressure test, just ask your agent (Claude Code, Codex, etc.) to evaluate and optimize your skill with Tessl. Ping me @yogesh-tessl, if you hit any snags.

Hey @admjs 👋

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 |
|-------|--------|-------|--------|
| build-list | 72% | 90% | +18% |
| enrich-contact | 75% | 75% | — |
| recommend-contacts | 74% | 74% | — |
| find-similar | 84% | 84% | — |
| enrich-company | 87% | 87% | — |

I focused on `build-list` since it had the most improvement headroom and is a core capability of the plugin — building targeted prospect lists is what most users reach for first.

<details>
<summary>Changes made to <code>build-list</code></summary>

- **Added "Use when..." clause** to the description with natural trigger terms (`prospect list`, `generate leads`, `find people`, `sales outreach list`) — helps Claude reliably select the skill
- **Added concrete MCP tool call examples** for `lookup` and `search_contacts` with real parameter syntax, so the agent knows exact invocation patterns
- **Added validation checkpoints** — lookup failure handling (suggest alternative terms) and zero-result fallback (auto-broaden filters with user notification)
- **Trimmed input examples** from 5 to 3 representative cases to reduce token overhead
- **Condensed output format** — removed empty table placeholders and tightened the refinement options section

</details>

I also stress-tested your `enrich-company` skill against a few real-world task evals and it held up really well on multi-input resolution — domain, ticker, and company name all routing correctly to the right enrichment parameters. Kudos for that.

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.

1 participant