Skip to content

feat: improve meeting-scheduler skill score (86% → 90%)#2

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

feat: improve meeting-scheduler skill score (86% → 90%)#2
yogesh-tessl wants to merge 1 commit into
superhuman:mainfrom
yogesh-tessl:improve/skill-review-optimization

Conversation

@yogesh-tessl

Copy link
Copy Markdown

Hey @lorilynsuperhuman 👋

this is seriously impressive. 5 skills covering everything from morning briefings to deal tracking, that's a really practical set. The way each one maps to a specific email workflow makes it clear you've thought about how people actually use their inbox.

Iran your skills through tessl skill review at work and found some targeted improvements for meeting-scheduler. Here's the before/after:

Skill Before After Change
meeting-scheduler 86% 90% +4%
What changed in meeting-scheduler
  • Expanded frontmatter description with concrete capability listing - now explicitly names contact resolution, cross-timezone availability checking, conflict detection, recurring meeting creation, and focus time blocking instead of relying on trigger phrases alone (Description: 90% → 100%)
  • Removed redundant "Important guidelines" section - every rule there (verify identity, confirm before booking, include user on invite, respect working hours, follow personalization settings) was already stated inline in the workflow steps
  • Trimmed introductory paragraphs - removed generic framing ("You are a scheduling assistant…") that added tokens without value since the workflow steps are self-explanatory
  • Tightened parameter documentation - shortened verbose explanations while keeping all MCP tool calls, parameter names, and format requirements intact
  • Folded recurrence field into Step 4a (direct booking) instead of a separate guideline, making it discoverable where it's actually used
  • Used quoted string format for the frontmatter description field

also stress-tested your meeting-scheduler skill against a few real-world task evals and it held up really well on cross-timezone scheduling with multi-participant availability filtering. Kudos for that.

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

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

| Skill | Before | After | Change |
|-------|--------|-------|--------|
| meeting-scheduler | 86% | 90% | +4% |
| morning-briefing | 86% | 86% | — |
| eod-wrapup | 90% | 90% | — |
| deal-tracker | 77% | 77% | — |
| batch-draft-writer | 86% | 86% | — |

<details>
<summary>What changed in <code>meeting-scheduler</code></summary>

- **Expanded frontmatter description** with concrete capability listing — now explicitly names contact resolution, cross-timezone availability checking, conflict detection, recurring meeting creation, and focus time blocking instead of relying on trigger phrases alone (Description: 90% → 100%)
- **Removed redundant "Important guidelines" section** — every rule there (verify identity, confirm before booking, include user on invite, respect working hours, follow personalization settings) was already stated inline in the workflow steps
- **Trimmed introductory paragraphs** — removed generic framing ("You are a scheduling assistant…") that added tokens without value since the workflow steps are self-explanatory
- **Tightened parameter documentation** — shortened verbose explanations while keeping all MCP tool calls, parameter names, and format requirements intact
- **Folded `recurrence` field** into Step 4a (direct booking) instead of a separate guideline, making it discoverable where it's actually used
- **Used quoted string format** for the frontmatter description field

Net result: 19 fewer lines, same full workflow coverage, zero domain knowledge lost.

</details>

I also stress-tested your `meeting-scheduler` skill against a few real-world task evals and it held up really well on cross-timezone scheduling with multi-participant availability filtering. 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 🙏
@yogesh-tessl

Copy link
Copy Markdown
Author

hey @lorilynsuperhuman, just resurfacing this in case it slipped by, let me know if any changes are needed!
Understand if there's a queue, take your time.

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