Skip to content
Skills Library
Documents & office · Conversion & formats

consulting-report

/consulting-report

Build a beautifully-typeset consulting-report PDF from a typed data file and a React layout. Use when generating an assessment, strategic review, operational readiness check, or any McKinsey-style consulting deliverable as a PDF.

Licence
MIT
Last repository change
23.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
62
Scripts
51
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 51 scripts in this package. Review them before installing, as Claude may execute them.

Scripts: demo/app/layout.tsx, demo/app/page.tsx, demo/components/callout.tsx, demo/components/comparison-table.tsx, demo/components/cover-page.tsx, demo/components/exhibit.tsx, demo/components/finding-card.tsx, demo/components/quote-block.tsx

What it does and when to use it

Build a beautifully-typeset consulting-report PDF from a typed data file and a React layout. Use when generating an assessment, strategic review, operational readiness check, or any McKinsey-style consulting deliverable as a PDF.

Arguments

/consulting-report scaffold <target-dir> | dev <report-dir> | <report-dir> (render PDF)
Original author description

Build a beautifully-typeset consulting-report PDF from a typed data file and a React layout. Use when generating an assessment, strategic review, operational readiness check, or any McKinsey-style consulting deliverable as a PDF.

How it works

  1. Overview
  2. Authoring contract — what belongs where
  3. Workflow
  4. Directory Layout
  5. Component Cheatsheet
  6. Demo
  7. Important
Original SKILL.md headings · 147 lines, 903 words
SKILL.md preview
---
name: consulting-report
license: MIT
description: "Build a beautifully-typeset consulting-report PDF from a typed data file and a React layout. Use when generating an assessment, strategic review, operational readiness check, or any McKinsey-style consulting deliverable as a PDF."
argument-hint: scaffold <target-dir> | dev <report-dir> | <report-dir> (render PDF)
metadata:
  source: portable-agent-layer
  triggers:
    - "consulting-report"
    - "consulting report"
    - "to pdf"
    - "design a pdf"
    - "beautiful pdf"
---

## Overview

Every report is a self-contained Next.js app: typed report data in `lib/report-data.ts`, layout composed from React components in `app/page.tsx`, font via `next/font/google` (Inter), Tailwind v4 for styling. `bun run dev` gives a live preview while authoring; the PDF is rendered by Playwright against a static export.

## Authoring contract — what belongs where

The split is deliberate. Don't edit the template for one report; don't put report data in the template.

| File | Lives in | Edited by |
|------|----------|-----------|
| `lib/types.ts` | Template | Skill maintainer only (when adding new section types) |
| `lib/report-data.ts` | Project | **You.** Replace the scaffolded placeholder with your data. |
| `app/page.tsx` | Project | **You.** Compose your layout from the components in `@/components`. |
| `components/*.tsx` | Template | Skill maintainer only (when adding new primitives) |
| `app/globals.css` | Project (copied from template) | Brand colors and project-specific overrides only. |

**Tunable parameters** (e.g., the "TUNABLE" marker on configuration rows) take their label from the data:

```ts
// In your project's report-data.ts:
{ name: "Decision band thresholds", currentValue: "16–20 strong …",
  tunable: true, tunableLabel: "Owner edit" }
```

The component renders whatever `tunableLabel` you provide; the template never hardcodes a person's name.

**Custom band labels** (Scorecard / BandBadge): the `band` field is a free-form string. Pass `bandStyles` to `<Scorecard>` to map your band labels to colors:

```tsx
<Scorecard
  scorecard={...}
  bandStyles={{
    Greenlit: { color: "...", background: "...", borderColor: "..." },
    Investigate: { ... },
    Hold: { ... },
  }}
/>
```

**Configurable columns** (ConfigurationTable, TuningLog): pass a `columns` prop to override the default schema. See each component's source for the column type.

**Rubric levels** (RubricTable): supports any number of levels — the colors sample the default palette evenly. Pass `palette` to override.

## Workflow

### 1. Scaffold a new report

```bash
pal cli skill run consulting-report scaffold <target-dir> \
  [--client "Client Name"] [--title "Report Title"] [--no-install]
```

Creates `<target-dir>` from the template and runs `bun install` inside. If `--client` / `--title` are passed, they're stamped into `lib/report-data.ts`. The scaffolder refuses to overwrite an existing directory.

### 2. Fill in the content

Two files do the work:

- **`lib/report-data.ts`** — typed metadata: client, title, date, classification, consultancy name, executive summary, situation assessment, findings, risk analysis, strategic opportunity, recommendations, target state, roadmap, call to action. The `ReportData` interface guides what's required.
- **`app/page.tsx`** — the layout. Composes `<CoverPage/>`, `<Section/>`, `<Exhibit/>`, `<FindingCard/>`, `<RecommendationCard/>`, `<Callout/>`, `<Timeline/>`, etc. against the data. Edit freely — section titles, intros, ordering, custom JSX, anything.

Static images go in `public/`; reference them from JSX as `<img src="/your-image.png">`.

### 3. Live preview while authoring

```bash
pal cli skill run consulting-report dev <report-dir>
```

Wraps `bun run dev` in the report directory. Open the URL printed by Next, edit `app/page.tsx` or `lib/report-data.ts`, browser hot-reloads.

### 4. Render the PDF

```bash
pal cli skill run consulting-report generate-pdf <report-dir>
```

Runs `next build` (which produces a static export at `out/`), then Playwright loads it via a tiny in-process HTTP server and prints the PDF with page-numbered header/footer. Output:

```
<report-dir>/<client-slug>-<title-slug>-<date>.pdf
```

Override with `--pdf <path>`. Pass `--skip-build` to re-render the PDF from the existing `out/` without re-building.

## Directory Layout

```
<report-dir>/
├── app/
│   ├── layout.tsx        # font wiring (Inter + Source Serif 4)
│   ├── page.tsx          # the report's layout — edit freely
│   └── globals.css       # design tokens via @theme + custom CSS
├── components/           # report primitives — edit if you need new shapes
│   ├── cover-page.tsx
│   ├── table-of-contents.tsx
│   ├── section.tsx
│   ├── exhibit.tsx
│   ├── stat-grid.tsx
│   ├── comparison-table.tsx
│   ├── finding-card.tsx
│   ├── recommendation-card.tsx
│   ├── severity-badge.tsx
│   ├── callout.tsx
│   ├── quote-block.tsx
│   └── timeline.tsx
├── lib/
│   ├── report-data.ts    # all your content
│   └── utils.ts
├── public/               # static images, optional
├── package.json          # exact-pinned: next, react, tailwindcss, etc.
├── tsconfig.json
├── next.config.js
└── postcss.config.mjs
```

## Component Cheatsheet

- `<CoverPage clientName reportTitle reportDate classification consultancyName preTitle />` — full-bleed cover
- `<TableOfContents items={[{id, title}, …]} title?>` — linked TOC, anchors to section IDs
- `<Section id title>` — top-level section with bottom-rule heading; `id` enables TOC links
- `<Exhibit number title source?>` — bordered card for figures, tables, side data
- `<StatGrid stats={[{value, label, caption?}, …]} />` — large-number grid for executive summary
- `<ComparisonTable leftLabel rightLabel rows={[{metric, left, right}, …]} metricLabel?>` — current vs. target side-by-side
- `<FindingCard finding={f} index={i} />` — driven by `Finding` type, includes severity badge
- `<RecommendationCard recommendation={r} index={i} />` — driven by `Recommendation` type, includes priority badge
- `<Callout label?>` — left-rule emphasis block (default label "Key Takeaway")
- `<QuoteBlock quote attribution role? />` — pull-quote with serif quote mark
- `<Timeline phases={r.roadmap} />` — vertical timeline with dotted line
- `<SeverityBadge severity />` — pill badge: critical / high / medium / low

## Demo

```bash
pal cli skill run consulting-report generate-pdf ~/.pal/skills/consulting-report/demo
```

Renders the bundled Acme Industries example end-to-end. Inspect the resulting PDF to see the full layout before authoring your own.

## Important

- Bundled fonts come from Google Fonts via `next/font/google` — no licensing surface, no CDN at runtime, glyphs embedded at build time
- Reports are disposable artifacts of `lib/report-data.ts` + `app/page.tsx`; commit the source, not the PDF
- The scaffolder runs `bun install` inside the target by default — pass `--no-install` to skip
- Header/footer templates render with `displayHeaderFooter: true` in Playwright; don't combine with CSS `@page` margin-box rules
Files in this package (62)
  • SKILL.md 7 KB
  • demo/.gitignore 1 KB
  • demo/bun.lock 26 KB
  • demo/next.config.js 1 KB
  • demo/package.json 1 KB
  • demo/postcss.config.mjs 1 KB
  • demo/tsconfig.json 1 KB
  • demo/app/globals.css 10 KB
  • demo/app/layout.tsx 1 KB
  • demo/app/page.tsx 11 KB
  • demo/components/callout.tsx 1 KB
  • demo/components/comparison-table.tsx 1 KB
  • demo/components/cover-page.tsx 1 KB
  • demo/components/exhibit.tsx 1 KB
  • demo/components/finding-card.tsx 1 KB
  • demo/components/quote-block.tsx 1 KB
  • demo/components/recommendation-card.tsx 1 KB
  • demo/components/section.tsx 1 KB
  • demo/components/severity-badge.tsx 1 KB
  • demo/components/stat-grid.tsx 1 KB
  • demo/components/table-of-contents.tsx 1 KB
  • demo/components/timeline.tsx 1 KB
  • demo/lib/report-data.ts 9 KB
  • demo/lib/utils.ts 1 KB
  • template/.gitignore 1 KB
  • template/bun.lock 26 KB
  • template/next.config.js 1 KB
  • template/package.json 1 KB
  • template/postcss.config.mjs 1 KB
  • template/tsconfig.json 1 KB
  • template/app/globals.css 4 KB
  • template/app/layout.tsx 1 KB
  • template/app/page.tsx 11 KB
  • template/components/band-badge.tsx 2 KB
  • template/components/callout.tsx 1 KB
  • template/components/code-block.tsx 1 KB
  • template/components/comparison-table.tsx 1 KB
  • template/components/configuration-table.tsx 3 KB
  • template/components/cover-page.tsx 3 KB
  • template/components/decision-table.tsx 2 KB
  • template/components/exhibit.tsx 1 KB
  • template/components/finding-card.tsx 1 KB
  • template/components/process-stage.tsx 1 KB
  • template/components/quote-block.tsx 1 KB
  • template/components/recommendation-card.tsx 2 KB
  • template/components/rubric-table.tsx 4 KB
  • template/components/score-badge.tsx 2 KB
  • template/components/scorecard.tsx 5 KB
  • template/components/section.tsx 1 KB
  • template/components/severity-badge.tsx 1 KB
  • template/components/stat-grid.tsx 1 KB
  • template/components/table-of-contents.tsx 1 KB
  • template/components/template-block.tsx 1 KB
  • template/components/tier-matrix.tsx 3 KB
  • template/components/timeline.tsx 1 KB
  • template/components/tuning-log.tsx 3 KB
  • template/lib/report-data.ts 4 KB
  • template/lib/types.ts 6 KB
  • template/lib/utils.ts 1 KB
  • tools/dev.ts 1 KB
  • tools/generate-pdf.ts 10 KB
  • tools/scaffold.ts 3 KB

Versions

The database has no other skills named consulting-report.

Database snapshot: 13.11.2026 · package version c536b1953435 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100mckinsey-deck
    Turn any content into a top-tier McKinsey-style deck — a 1280×720 page-turning HTML presentation that also prints to a clean per-slide PDF. Use when the user wants a "McKinsey-style deck / presentation", a polished slide deck or PDF from notes/content, an…
  • 90consulting
    McKinsey/BCG-tier strategy decks. Dense, structured, signal-color callouts on neutral grounds. Use when the user asks for 'strategy', 'consulting', 'case', 'recommendation', 'McKinsey-style', 'BCG-style', 'consulting deck'.
  • 100mckinsey-charts
    Generate McKinsey-style consulting charts as native python-pptx objects (editable inside PowerPoint). Three workhorse types — bar+callout for TAM/single-number stories, stacked column over time for revenue/usage mix, and waterfall for drivers/bridge analysis. Use when you need a…
  • 90paw-tools-presentation
    Generates McKinsey-style HTML presentations from marketing content. Use when user requests to 'create a presentation', 'generate a report', or 'build a deck' from marketing strategy or plan content.
  • 100consulting-gauntlet
    Full-stack consulting engagement simulator. Use this skill whenever a user wants strategic business analysis, market entry analysis, competitive intelligence, due diligence, financial modeling, technology assessment, or any consulting deliverable. Triggers include: "analyze this…
  • 90recoup-internal-consulting-proposal-designer
    INTERNAL — Recoup staff consulting workflow. Use for recoup-internal consulting requests. Render approved proposal copy and commercial terms as a branded two-page HTML/PDF document. Use after proposal drafting and pricing, when the user needs the final visual artifact.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.