bi-agents/.agents/skills/bmad-agent-builder/assets/quality-report-template.md

Quality Report: {agent-name}

Scanned: {timestamp} Skill Path: {skill-path} Report: {report-file-path} Performed By QualityReportBot-9001 and {user_name}

Executive Summary

• Total Issues: {total-issues}
• Critical: {critical} | High: {high} | Medium: {medium} | Low: {low}
• Overall Quality: {Excellent|Good|Fair|Poor}
• Overall Cohesion: {cohesion-score}
• Craft Assessment: {craft-assessment}

{executive-narrative}

Issues by Category

Category	Critical	High	Medium	Low
Structure & Capabilities	{n}	{n}	{n}	{n}
Prompt Craft	{n}	{n}	{n}	{n}
Execution Efficiency	{n}	{n}	{n}	{n}
Path & Script Standards	{n}	{n}	{n}	{n}
Agent Cohesion	{n}	{n}	{n}	{n}
Creative	—	—	{n}	{n}

---

Agent Identity

• Persona: {persona-summary}
• Primary Purpose: {primary-purpose}
• Capabilities: {capability-count}

---

Strengths

What this agent does well — preserve these during optimization:

{strengths-list}

---

{if-truly-broken}

Truly Broken or Missing

Issues that prevent the agent from working correctly:

{truly-broken-findings}

---

{/if-truly-broken}

Detailed Findings by Category

1. Structure & Capabilities

{if-structure-metadata} Agent Metadata:

• Sections found: {sections-list}
• Capabilities: {capabilities-count}
• Memory sidecar: {has-memory}
• Headless mode: {has-headless}
• Manifest valid: {manifest-valid}
• Structure assessment: {structure-assessment} {/if-structure-metadata}

{structure-findings}

2. Prompt Craft

Agent Assessment:

• Agent type: {skill-type-assessment}
• Overview quality: {overview-quality}
• Progressive disclosure: {progressive-disclosure}
• Persona context: {persona-context}
• {skillmd-assessment-notes}

{if-prompt-health} Prompt Health: {prompts-with-config-header}/{total-prompts} with config header | {prompts-with-progression}/{total-prompts} with progression conditions | {prompts-self-contained}/{total-prompts} self-contained {/if-prompt-health}

{prompt-craft-findings}

3. Execution Efficiency

{efficiency-issue-findings}

{if-efficiency-opportunities} Optimization Opportunities:

{efficiency-opportunities} {/if-efficiency-opportunities}

4. Path & Script Standards

{if-script-inventory} Script Inventory: {total-scripts} scripts ({by-type-breakdown}) | Missing tests: {missing-tests-list} {/if-script-inventory}

{path-script-findings}

5. Agent Cohesion

{if-cohesion-analysis} Cohesion Analysis:

Dimension	Score	Notes
Persona Alignment	{score}	{notes}
Capability Completeness	{score}	{notes}
Redundancy Level	{score}	{notes}
External Integration	{score}	{notes}
User Journey	{score}	{notes}

{if-consolidation-opportunities} Consolidation Opportunities:

{consolidation-opportunities} {/if-consolidation-opportunities} {/if-cohesion-analysis}

{cohesion-findings}

{if-creative-suggestions} Creative Suggestions:

{creative-suggestions} {/if-creative-suggestions}

6. Creative (Edge-Case & Experience Innovation)

Agent Understanding:

• Purpose: {skill-purpose}
• Primary User: {primary-user}
• Key Assumptions: {key-assumptions-list}

Enhancement Findings:

{enhancement-findings}

{if-top-insights} Top Insights:

{top-insights} {/if-top-insights}

---

{if-user-journeys}

User Journeys

How different user archetypes experience this agent:

{archetype-name}

{journey-summary}

Friction Points: {friction-points-list}

Bright Spots: {bright-spots-list}

---

{/if-user-journeys}

{if-autonomous-assessment}

Autonomous Readiness

• Overall Potential: {overall-potential}
• HITL Interaction Points: {hitl-count}
• Auto-Resolvable: {auto-resolvable-count}
• Needs Input: {needs-input-count}
• Suggested Output Contract: {output-contract}
• Required Inputs: {required-inputs-list}
• Notes: {assessment-notes}

---

{/if-autonomous-assessment}

{if-script-opportunities}

Script Opportunities

Existing Scripts: {existing-scripts-list}

{script-opportunity-findings}

Token Savings: {total-estimated-token-savings} | Highest value: {highest-value-opportunity} | Prepass opportunities: {prepass-count}

---

{/if-script-opportunities}

Quick Wins (High Impact, Low Effort)

Issue	File	Effort	Impact
{quick-wins-rows}

---

Optimization Opportunities

Token Efficiency: {token-optimization-narrative}

Performance: {performance-optimization-narrative}

Maintainability: {maintainability-optimization-narrative}

---

Recommendations

1. {recommendation-1}
2. {recommendation-2}
3. {recommendation-3}
4. {recommendation-4}
5. {recommendation-5}