Refine

What the source does

• FilesystemNone observedNo reads or writes in the source
• NetworkNone observedNo outbound calls in the source
• ShellNone observedNo commands run in the source
• DependenciesPinnedNothing floats
• SecretsNone foundNo keys in source

Five audit layers

Gates applied: no behavioural pass.

Audit 0.4.1 · source sha 4e163a7a8095 · 19 Oct 2026Report an issue or request a re-scan

• Publishersharpdeveye GitHub userOwner of the repository this skill is read from
• Source foldersharpdeveye/maestro/source/skills/refineThe exact folder we audited
• LicenceMITAs the repository states it
• Commit pinned for this verdict4e163a7a8095A new audit runs when the source changes
• Repository statusNot archivedLast push 173 days ago
• Sandboxed runNot runSkills are read, not executed; layer L4 is skipped

Its description: Use when the workflow works but needs polish, or as the final step in a diagnose → fix → refine cycle before shipping.

---
name: refine
description: "Use when the workflow works but needs polish, or as the final step in a diagnose → fix → refine cycle before shipping."
argument-hint: "[target area]"
category: fix
version: 2.0.0
user-invocable: true
---

## 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**

- [ ] Error messages are specific (not "an error occurred")
- [ ] Error messages suggest corrective action
- [ ] Errors include context (what was being attempted)
- [ ] Errors are structured (code + message + details)

**Logging**

- [ ] Every model call is logged (input tokens, output tokens, latency, cost)
- [ ] Tool calls are logged with inputs and outputs
- [ ] Errors are logged with full context
- [ ] PII is redacted from logs
- [ ] Workflow ID traces through all log entries

**Configuration**

- [ ] All magic numbers are named constants
- [ ] Environment-specific values are in config, not code
- [ ] Defaults are sensible — config is for overrides
- [ ] Cost ceilings are set
- [ ] Timeout values are set for all external calls

### Output

For each checklist item that fails, provide:

1. What's wrong (specific finding)
2. Where it is (file, line, or component)
3. How to fix it (concrete suggestion)
4. Priority (critical / important / nice-to-have)

### Priority Matrix

| Priority | Criteria | Maestro Action |
|----------|---------|----------------|
| Critical | Affects correctness or safety | `/fortify` or `/guard` before shipping |
| Important | Affects quality or maintainability | `/calibrate` in current cycle |
| Nice-to-have | Cosmetic or minor inconsistency | Note for next `/refine` pass |

### Recommended Next Step

After refinement is complete, run `/evaluate` to verify the polished workflow against realistic scenarios.

**NEVER**:

- Skip the checklist — go through every item
- Mark items as passing without checking
- Suggest changes that alter behavior (this is polish, not redesign)
- Refine before the workflow is functionally correct (fix first, refine last)

Excerpt, first 2,922 characters of SKILL.md, verbatim from the audited commit. It is text from someone else’s repository, quoted so you can judge it before your agent reads it.

git clone https://github.com/sharpdeveye/maestro
git -C maestro checkout 4e163a7a8095

Works in

1. 2026-10-19
   ✓SAFE B 89 / 100

   first audit · source 4e163a7a8095

Questions about Refine

• github.com/sharpdeveye/maestro/tree/main/source/skills/refine — the audited source at commit 4e163a7a8095 and every finding aboveObserved · 19 Oct 2026

Spotted something wrong? Report a correction · Methodology