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.
- Author
- kovrichard ↗
- Repository
- portable-agent-layer ↗
- Licence
- MIT
- Last repository change
- 23.10.2026
Assessment and security
- Files in this package
- 62
- Scripts
- 51
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 23.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 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
- Overview
- Authoring contract — what belongs where
- Workflow
- Directory Layout
- Component Cheatsheet
- Demo
- Important
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.