competitive-report-structure
The competitive-report-structure skill assembles scored competitor analysis into a decision-focused report that answers who competitors are, how they compete, and where defensible white-space exists. Use it after benchmark-methodology competitor cards are complete and findings must drive strategic choices for founders, leadership, or boards through an auditable, positioning-based narrative.
git clone --depth 1 https://github.com/affaan-m/ECC /tmp/competitive-report-structure && cp -r /tmp/competitive-report-structure/.agents/skills/competitive-report-structure ~/.claude/skills/competitive-report-structureSKILL.md
# Competitive Report Structure Use this skill to assemble scored competitor cards into a decision-grade report. The report must answer three questions for the client: **who do we compete with, how do we compete, and where is our defensible white-space?** Every section earns its place by moving toward those answers — cut anything that doesn't. ## When to Activate - All competitor profile cards from benchmark-methodology are complete and ready to assemble. - Need to present competitive findings to a founder, leadership team, or board. - The report must drive decisions (who to compete with, how, where the moat is) — not just document the landscape. - Preparing a client deliverable that must be auditable and defensible. ## Client positioning brief (establish first) Before assembling the report, establish the client's positioning brief. It supplies: - **Strategic tension** — the paired axes (e.g., memorability × hireability) that define the client's target white-space. All maps and synthesis resolve back to this tension. - **Brand balance** — the intended proportional mix of the client's strategic emphases (e.g., 60% strategy/evidence, 25% distinctiveness, 15% craft). Every recommendation must be checked against this balance; flag any that would shift it. - **Differentiator** — the framing principle for the executive summary and white-space section. - **Target quadrant** — where the client intends to sit in the tension map; confirming whether that quadrant is genuinely open is the report's central empirical question. ## Framing principle The whole report is organized around the client's strategic tension and recommendations resolve back to the client's deliberate brand balance. Recommendations that would break that balance must be flagged against it explicitly — "this move shifts the balance from X/Y/Z toward A/B/C; confirm intent." ## Report sections ### 1. Executive summary 3–5 takeaways, decision-first. State the most important findings in plain language: where the client is strong, where it's exposed, who occupies its target white-space, and the top 2–3 moves. Written so a founder/PM reads only this and knows what to do. No methodology here. ### 2. Market landscape & category framing Define the category and map it. Use a **multi-axis map** — at minimum a 2×2 (e.g., *brand-led <-> capability-led* × *boutique <-> enterprise-scale*), and ideally the **client's tension plot** from `benchmark-methodology` as the headline map. Place every profiled competitor and the client. The map should make the client's intended position visually obvious and show how crowded (or empty) it is. ### 3. Competitor tiers Organize the set into **Direct / Adjacent / Aspirational** (from `competitive-platform-analysis`). One short paragraph per tier explaining who's in it and why it matters to the client. This sets reader expectations before the detail. ### 4. Benchmarking matrix The full **competitors × dimensions** table — the quantitative spine. Rows = competitors (grouped by tier), columns = the nine benchmark dimensions (note: dimension 9 — strategic tension — has two poles (e.g., Memorability and Hireability for a brand-studio client; substitute the client's own paired axes); represent them as two separate sub-columns rather than averaging them). Include the client's own honest self-assessment as a row for contrast. Use a **heatmap** (color or symbol scale) so strength/weakness patterns are scannable. Do **not** add a blended total column — report dimensions separately (per the bias controls). Call out the columns where the client leads and where it trails. ### 5. Deep dives 3–5 most instructive competitors in narrative form (from their profile cards). Choose for instruction, not ranking: the best exemplar of the target tension (high on both poles), the cautionary "one pole only" case, the "competent but forgettable" archetype the client defines against, plus any direct threat. Each deep dive: what they do, what the client should learn, what the client should avoid. ### 6. White-space & threats The strategic heart. Two parts: - **White-space:** the position the client can own that rivals don't — argued from the maps and matrix, not asserted. Confirm whether the target quadrant (from the positioning brief) is genuinely open. - **Threats:** who/what pressures the client — a rival closing the gap, substitutes (no-code/AI tools, in-house teams, generalist freelancers), or category shifts. Be honest about the client's own risks (e.g., a bold identity reading as un-serious to risk-averse buyers). ### 7. Strategic recommendations Concrete, prioritized moves: who the client competes with, how it differentiates, and where to invest (offer packaging, evidence/case studies, thought leadership, brand sharpening). **Tie every recommendation back to the brand balance from the positioning brief** and flag any that would shift it. Sequence by impact × effort. ### 8. Sources / methodology appendix The dimensions, weights, rubrics, the scoped set with tiers, source links per competitor, and verification notes (asserted vs proven). This is what makes the report auditable and defensible — carry the adversarial citation discipline through. ## How to present data - **2×2 / positioning maps** — for landscape and the tension plot. Lead with these; they carry the argument faster than prose. - **Heatmap matrix** — for the competitors × dimensions comparison (section 4). - **Profile cards** — the source unit feeding deep dives (section 5). - **Quadrant callouts** — name who sits in each quadrant explicitly, especially the client's target one. - Keep tables scannable; push raw evidence and links to the appendix. ## Decision framework (the report must resolve these) - **Who do we compete with?** — Name the Direct tier specifically; that's the real fight. - **How do we compete?** — State the client's differentiator in one sentence, grounded in the matrix (which dimensions the client
Structured self-debugging workflow for AI agent failures using capture, diagnosis, contained recovery, and introspection reports.
Build an evidence-backed ECC install plan for a specific repo by sorting skills, commands, rules, hooks, and extras into DAILY vs LIBRARY buckets using parallel repo-aware review passes. Use when ECC should be trimmed to what a project actually needs instead of loading the full bundle.
>
Write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive voice derived from supplied examples or brand guidance. Use when the user wants polished written content longer than a paragraph, especially when voice consistency, structure, and credibility matter.
>
Build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then reuse that profile across content, outreach, and social workflows. Use when the user wants voice consistency without generic AI writing tropes.
Bun as runtime, package manager, bundler, and test runner. When to choose Bun vs Node, migration notes, and Vercel support.
>