Diagnose
This is essentially a linter for your AI workflows. It scores your setup across five dimensions: prompt quality, context efficiency, tool health, architecture fitness, and safety. Each dimension gets a 1-5 rating with specific findings, then it maps the gaps to concrete Maestro commands like /fortify or /streamline. The scoring rubric is strict, anything below a 3 means you've got real problems to fix. What I like here is that it doesn't just tell you what's wrong, it tells you which command to run next. The tool health dimension is especially practical, flagging things like too many tools (over 7 is a red flag) or missing error handling. Good for periodic health checks or when something feels off but you can't pinpoint why.
- skills.sh installs
- 362
- GitHub stars
- 602
- last updated
- Aug 21, 2026
Install
$ npx -y skills add sharpdeveye/maestro --skill diagnose --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.
Perform a systematic diagnostic scan across 5 dimensions. For each dimension, score 1-5 and provide specific findings.
Dimension 1: Prompt Quality (1-5)
Evaluate:
- Structure (4-zone pattern: role, context, instructions, output)
- Output schema definition (explicit vs. implicit)
- Instruction clarity (specific vs. vague)
- Edge case handling (addressed vs. ignored)
- Anti-patterns present (wall of text, contradictions, implicit format)
Dimension 2: Context Efficiency (1-5)
Evaluate:
- Context budget allocation (planned vs. ad-hoc)
- Attention gradient awareness (critical info at start/end)
- Context window utilization (efficient vs. wasteful)
- State management (explicit vs. implicit)
- Memory strategy (appropriate for conversation length)
Dimension 3: Tool Health (1-5)
Evaluate:
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
- Code Review & Quality, Debugging, Automation & Workflows
- First seen
- Jun 3, 2026
More from sharpdeveye/maestro
All 22Recommended
More Code Review & Quality
design-patterns-expertrysweet/amplihackComprehensive knowledge of all 23 Gang of Four design patterns with progressive disclosure (Quick/Practical/Deep), pattern recognition for problem-solving, and 359skills.sh installs
auth-security-reviewerpatricio0312rev/skillsReviews authentication and authorization implementation for session management, CSRF, cookie security, and auth flow vulnerabilities with findings, severity ass352skills.sh installs
evaluating-code-modelsdavila7/claude-code-templatesEvaluates code generation models across HumanEval, MBPP, MultiPL-E, and 15+ benchmarks with pass@k metrics. Use when benchmarking code models, comparing coding 350skills.sh installs
image-genjezweb/claude-skillsGenerate website images with Gemini 3 Native Image Generation. Covers hero banners, service cards, infographics with legible text, and multi-turn editing. Inclu350skills.sh installs
uniwindpproenca/dot-skillsUniwind best practices for React Native styling with Tailwind CSS. This skill should be used when writing, reviewing, or refactoring React Native code using Uni348skills.sh installs
nestjs-modular-monolithtech-leads-club/agent-skillsSpecialist in designing and implementing scalable modular monolith architectures using NestJS with DDD, Clean Architecture, and CQRS patterns. Use when building344skills.sh installs