Skip to content

feat: improve zork skill score from 17% to 94%#2

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

feat: improve zork skill score from 17% to 94%#2
rohan-tessl wants to merge 1 commit intojonathanprozzi:mainfrom
rohan-tessl:improve/skill-review-optimization

Conversation

@rohan-tessl
Copy link
Copy Markdown

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

Hey @jonathanprozzi 👋

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

Here's the full before/after:

Skill Before After Change
zork 17% 94% +77%

This repo has one skill, so this PR covers the full scope — no follow-ups needed.

Changes made
  • Fixed frontmatter description: Removed XML-like <command> tag that caused validation failure (was blocking all judge evaluation). Rewrote as a proper quoted string with explicit "Use when..." trigger clause
  • Restructured body with clear workflow: Added numbered workflow steps (play, status, new game, Obsidian sync) for better actionability
  • Improved command table: Mapped each /zork invocation to its underlying script with arguments, making the skill more actionable for the agent
  • Added troubleshooting section: Brief error handling guidance for missing dfrotz and corrupted save state
  • Added progressive disclosure: Deferred installation details and dfrotz flags to README.md instead of duplicating in SKILL.md
  • Streamlined game state section: Clarified file paths and removed redundant descriptions

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

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 |
|-------|--------|-------|--------|
| zork | 17% | 94% | +77% |

This repo has one skill, so this PR covers the full scope — no follow-ups needed.

Changes made:
- Fixed frontmatter description: removed XML-like <command> tag that caused validation failure
- Rewrote description as quoted string with explicit "Use when..." trigger clause
- Restructured body with numbered workflow steps for better actionability
- Improved command table mapping invocations to underlying scripts
- Added troubleshooting section for missing dfrotz and corrupted saves
- Added progressive disclosure deferring install details to README.md
- Streamlined game state section with clarified file paths

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.
@rohan-tessl rohan-tessl marked this pull request as ready for review April 2, 2026 07:53
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