feat: improve devvit-docs skill score (85% → 89%)

[yogesh-tessl]

Hey @mwood23 👋

the Devvit skills are nicely scoped, especially the docs skill that pulls citations directly from reddit/devvit-docs and the logs skill for quick debugging. The README examples showing exactly when to use each skill make it really easy for agents to pick the right one.

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

Skill	Before	After	Change
devvit-docs	85%	89%	+4%

Changes made to devvit-docs

• Expanded frontmatter description - listed specific capabilities (search docs, find code examples, explain API usage, retrieve config patterns) instead of just "look up documentation", improving agent trigger specificity
• Fixed filename bug - ensure-docs.js → ensure-docs.cjs in the "How It Works" workflow to match the actual script
• Added validation checkpoint - step to verify docsRoot exists and contains .md files before searching, with fallback to repoDir/docs/
• Added concrete search example - find/grep pattern in the workflow so the agent knows exactly how to search the docs directory

---

also stress-tested your devvit-docs skill against a few real-world task evals and it held up really well on version-specific doc lookups with --project-dir detection. 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.

[yogesh-tessl]

hey @mwood23, 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.