Refine
This is your final quality pass before shipping a working workflow. It runs through a comprehensive checklist covering prompts, tool descriptions, error messages, logging, and configuration, then tells you exactly what's broken, where it is, and how to fix it with a priority rating. The checklist is opinionated but practical: four-zone prompt patterns, explicit output schemas, specific error messages with corrective actions, PII redaction in logs, no magic numbers. It explicitly won't change behavior or suggest redesigns, just polish what already works. Best used after your workflow functions correctly but before you'd feel comfortable handing it to someone else. The mandatory context gathering step means it needs existing workflow state to audit against.
- skills.sh installs
- 357
- GitHub stars
- 602
- last updated
- Aug 21, 2026
Install
$ npx -y skills add sharpdeveye/maestro --skill refine --agent claude-codeInstalls into .claude/skills of the current project.
Files
MANDATORY PREPARATION
Invoke /agent-workflow — it contains workflow principles, anti-patterns, and the Context Gathering Protocol. Follow the protocol before proceeding — if no workflow context exists yet, you MUST run /teach-maestro first.
This is the final quality pass. The workflow works — now make it excellent.
Refinement Checklist
Prompts
- Every prompt follows the 4-zone pattern (role, context, instructions, output)
- Output schemas are explicit and validated
- Negative instructions clarify what NOT to do
- No contradictory instructions
- Few-shot examples included for ambiguous tasks
- Chain-of-thought used for multi-step reasoning tasks
Tool Descriptions
- Every tool has a multi-line description: what, when to use, when NOT to use, returns
- Input parameters have descriptions and types
- Error responses are documented
- At least one example input/output in the description
Error Messages
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/sharpdeveye/maestro
- Categories
- Debugging, Automation & Workflows
- First seen
- Jun 3, 2026
More from sharpdeveye/maestro
All 22Recommended
More Debugging
cloudflare-kvjezweb/claude-skillsStore key-value data globally with Cloudflare KV's edge network. Use when: caching API responses, storing configuration, managing user preferences, handling TTL355skills.sh installs
ros2-developmentarpitg1304/robotics-agent-skillsComprehensive best practices, design patterns, and common pitfalls for ROS2 (Robot Operating System 2) development. Use this skill when building ROS2 nodes, pac353skills.sh installscloudflare-turnstilejezweb/claude-skillsAdd bot protection with Turnstile (CAPTCHA alternative). Use when: protecting forms, securing login/signup, preventing spam, migrating from reCAPTCHA, integrati348skills.sh installs
flutter-duit-bduimadteacher/mad-agents-skillsIntegrate, fix, review, migrate, test, or debug Duit / flutter_duit backend-driven UI in Flutter applications. Use when a task mentions DUIT, flutter_duit, back346skills.sh installs
vercel-observabilitybobmatnyc/claude-mpm-skillsVercel observability for Web Analytics, Speed Insights, logs, tracing, alerts, and observability tooling. Use when monitoring performance or debugging productio345skills.sh installs
nocobase-workflow-managenocobase/skillsUse when users need to inspect, create, update, copy, enable, or diagnose NocoBase workflows through `nb`, including version-safe edits, node changes, approval 344skills.sh installs