calibrate
Use when workflow components are inconsistent, naming conventions vary, or a new team member's work needs alignment to project standards.
pinned to #00f9115updated 3 months ago
Ask your AI client: “install skills/calibrate”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/calibratemetahub onboarded this repo on the author's behalf.
If you own github.com/sharpdeveye/maestro on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
402
Last commit
3 months ago
Latest release
published
- #agent-orchestration
- #ai
- #ai-agents
- #ai-workflows
- #claude-code
- #codex
- #copilot
- #cursor
- #developer-tools
- #gemini
- #open-source
- #prompt-engineering
- #skills
Automated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.00f9115· 3 months ago
Behavioral checks ran but aren't published for this artifact; the static checks above ran at publish time.
Kind-specific
3 passed1 warningSkill: triggers declaredwarn
No `trigger` phrases in SKILL.md frontmatter
Add `trigger:` lines so Claude knows when to activate this skill — e.g. `when building MCP servers` or `for diagram creation`.
Skill: SKILL.md present
found at source/skills/calibrate/SKILL.md · frontmatter source: SKILL.md
Skill: body content present
425 words · 2,867 chars · 6 sections
Skill: allowed-tools scope
no allowed-tools restriction (Claude may use anything)
Release history
1- releasecurrent00f9115warn3 months ago
Contents
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. Consult the prompt-engineering reference in the agent-workflow skill for naming and style consistency patterns.
Ensure consistency across all workflow components. Inconsistency creates confusion — for the model, for developers, and for users.
Calibration Dimensions
Naming Conventions
- Tool names follow consistent pattern (verb_noun, noun.verb, or camelCase — pick one)
- Agent names follow consistent pattern
- Configuration keys follow consistent pattern
- File names follow consistent pattern
Prompt Style
- All prompts use the same structural pattern (4-zone)
- Consistent delimiter style (XML tags, markdown headers, triple-dash)
- Consistent output schema format (JSON schema, markdown template)
- Consistent instruction style (imperative, numbered steps)
Error Handling
- All tools return errors in the same format
- Error codes follow consistent scheme
- Error messages follow consistent tone
- Retry logic uses consistent strategy
Logging
- All logs use the same format (JSON structured, text, etc.)
- Consistent field names across all log entries
- Consistent log levels (debug, info, warn, error)
- Consistent PII redaction approach
Calibration Process
- Identify the standard: What's the most common pattern in the existing codebase? That's the standard.
- List deviations: Find all components that deviate from the standard.
- Prioritize: Fix the most impactful deviations first (user-facing > internal).
- Apply: Make the changes, ensuring tests still pass.
- Document: Update
.maestro.mdwith the established conventions.
Consistency Audit Table
| Dimension | Standard | Deviations Found | Priority |
|---|---|---|---|
| Tool naming | ? | ? of ? tools | High/Med/Low |
| Prompt structure | ? | ? of ? prompts | High/Med/Low |
| Error format | ? | ? of ? tools | High/Med/Low |
| Log format | ? | ? of ? entries | High/Med/Low |
Calibration Checklist
- Convention standard identified for each dimension
- All deviations listed with location
- Highest impact deviations fixed first
- Tests pass after each calibration change
- Updated
.maestro.mdwith established conventions
Recommended Next Step
After calibration, run /refine for a final polish pass, or /evaluate to verify consistency improvements.
NEVER:
- Invent new conventions when existing ones work
- Calibrate in a way that changes behavior (this is standardization, not refactoring)
- Skip test verification after calibration
- Change naming conventions without updating all references
Reviews
No reviews yet. Be the first.
Related
Verification Before Completion
Evidence before assertions, always
Writing Plans
Turn specs into phased implementation plans
Test-Driven Development
Red → green → refactor discipline for any feature or bugfix
mh install skills/calibrate