Home / radekamirko / c.r.i.s.p · .claude/skills/crisp-report/SKILL.md · GitHub

crisp-report skillA

crisp-report is agent-read markdown (skill) from radekamirko/c.r.i.s.p: Generate a beautiful single-file HTML report from the project's docs/ folder. Works after any CRISP phase, after Archaeology, or at sprint close in Execute. Triggers on "generate report", "export docs", "create HTML report", "share docs", or automatically at sprint close in CRISP Execute..

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# CRISP Report Generator

Converts all markdown files in `docs/` into a single self-contained HTML file — cards overview, click-through to full documents, beautiful dark theme, no dependencies.

---

## How to run

**Step 1: Check dependencies**

```bash
pip3 install markdown pygments
```

If pip3 isn't available, try: `python3 -m pip install markdown pygments`

**Step 2: Run the script**

```bash
python3 scripts/generate-report.py [docs_dir] [output_file]
```

Defaults:
- `docs_dir` → `./docs`
- `output_file` → `./crisp-report.html`

Examples:
```bash
# Default — reads ./docs, outputs ./crisp-report.html
python3 scripts/generate-report.py

# Custom paths
python3 scripts/generate-report.py ./docs ./reports/sprint-3-report.html
```

**Step 3: Open**

```bash
open crisp-report.html
```

Or share the file directly — it's fully self-contained. No server needed.

---

## What it produces

- **Overview page** — card grid, one card per document, grouped by section (Discovery / Spec / Archaeology / Execute)
- **Document pages** — click any card → full rendered document with proper typography, code highlighting, tables
- **Escape / Back** → returns to overview
…

Read the whole file at its exact version.

How to install

Latest version
mdr add radekamirko/c.r.i.s.p/crisp-report@git:20260603.8c4efc7
Exact content
mdr add radekamirko/c.r.i.s.p/crisp-report@sha256:339cbe854b599122

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_iwaz44trfiel7e2d.svg)](https://markdownregistry.com/a/art_iwaz44trfiel7e2d)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260603.8c4efc7 latest2026-06-03 8c4efc7 3,109 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3109 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

radekamirko/c.r.i.s.p · 52 stars · license MIT · pushed 2026-09-18 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_iwaz44trfiel7e2d
GET https://markdownregistry.com/api/v1/resolve?ref=radekamirko/c.r.i.s.p/crisp-report
GET https://markdownregistry.com/api/v1/blob/339cbe854b59912209b9912bb0bb01e9aac9767c45d0e4142ed26de1900e1080

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from radekamirko/c.r.i.s.p

crisp-execute skill
radekamirko/c.r.i.s.p · .claude/skills/crisp-execute/SKILL.md · CRISP Execute — Sprint execution loop with change request management, security gates, product gates, and stakeholder…
git:20260601.649f845 · audit A · 52 stars
crisp-orchestrator skill
radekamirko/c.r.i.s.p · .claude/skills/crisp-orchestrator/SKILL.md · CRISP session manager — detects project state and routes to the right entry point. Use /crisp to start or resume any…
git:20260601.00afa9f · audit A · 52 stars
crisp-start skill
radekamirko/c.r.i.s.p · .claude/skills/crisp-start/SKILL.md · Begin a CRISP product discovery session — Phase C (Clarify)
git:20260401.c120450 · audit A · 52 stars
phase1-clarify skill
radekamirko/c.r.i.s.p · .claude/skills/phase1-clarify/SKILL.md · The Mileva Method (CRISP) — Phase 1: Clarify. Problem definition, eliciting, painkiller test, buy vs build, AI…
git:20260423.24fa8e6 · audit A · 52 stars
phase2-results skill
radekamirko/c.r.i.s.p · .claude/skills/phase2-results/SKILL.md · The Mileva Method (CRISP) — Phase 2: Results. Outcome alignment, stakeholder register, baseline measurement, success…
git:20260423.24fa8e6 · audit A · 52 stars
phase3-investigate skill
radekamirko/c.r.i.s.p · .claude/skills/phase3-investigate/SKILL.md · The Mileva Method (CRISP) — Phase 3: Investigate. Process mapping for existing or greenfield processes, user journey…
git:20260423.24fa8e6 · audit A · 52 stars
phase4-spec skill
radekamirko/c.r.i.s.p · .claude/skills/phase4-spec/SKILL.md · The Mileva Method (CRISP) — Phase 4: Spec. Full implementation readiness package including solution design, UX…
git:20260423.24fa8e6 · audit A · 52 stars
phase5-prove skill
radekamirko/c.r.i.s.p · .claude/skills/phase5-prove/SKILL.md · The Mileva Method (CRISP) — Phase 5: Prove. Success validation against Phase R baseline metrics, test log review, and…
git:20260423.24fa8e6 · audit A · 52 stars
CLAUDE.md claude
radekamirko/c.r.i.s.p · CLAUDE.md
git:20260417.ca34447 · audit A · 52 stars
CLAUDE.md@examples/longevity-platform claude
radekamirko/c.r.i.s.p · examples/longevity-platform/CLAUDE.md
git:20260323.c85b016 · audit A · 52 stars
CLAUDE.md@templates claude
radekamirko/c.r.i.s.p · templates/CLAUDE.md
git:20260601.649f845 · audit A · 52 stars

Every file in radekamirko/c.r.i.s.p

Browse by kind, by grade A, or by owner.