feat: improve zuplo-guide skill score from 74% to 90%

[yogesh-tessl]

Hey @ntotten 👋

that is really clean setup, covering both Zuplo and Zudoku in one repo and supporting both Claude Code and Cursor plugin installs. The agentskills.io integration makes it easy for people to discover these.

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

Skill	Before	After	Change
zuplo-guide	74%	90%	+16%

picked zuplo-guide because it had the most headroom and it's the "front door" skill, the one users hit first for general Zuplo development.

Changes made to zuplo-guide

• Expanded description with natural trigger terms - added "rate limiting", "API keys", "JWT", "OAuth", "CORS", "API proxy", "API management" so the skill gets matched when users describe tasks in everyday language (not just Zuplo-internal terminology)
• Added concrete route configuration example - a copy-paste-ready routes.oas.json snippet with x-zuplo-route, urlForwardHandler, and inbound policy references
• Added concrete policy configuration example - a policies.json snippet showing API key auth and rate limiting setup with realistic options
• Added specific CLI validation commands - npx zuplo dev, npx zuplo test, npx zuplo deploy, and npx zuplo list in the development workflow and error handling sections
• Added explicit feedback loop - "if tests fail, read the error output, fix the configuration, and re-run before deploying"
• Reduced repetition - consolidated the "read docs first" messaging to a single concise critical rule instead of restating it in multiple sections
• Tightened core concepts - removed redundant explanations, clarified policy pipeline directionality (inbound before handler, outbound after)

---

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.

[Copilot]

Pull request overview

Improves the zuplo-guide skill’s matchability and usefulness by expanding its description with common trigger terms and adding concrete configuration/workflow examples for Zuplo routes, policies, and CLI validation steps.

Changes:

• Expanded the skill frontmatter description with additional Zuplo-relevant trigger terms (auth, rate limiting, CORS, proxying, etc.).
• Added example routes.oas.json / policies.json snippets plus CLI validation/deploy commands and a tighter troubleshooting workflow.
• Refined core concepts phrasing (policy pipeline directionality, web-standards runtime) and reduced repeated “read docs” messaging.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.