How do I install the Generate Report skill?

Run npx skillmds@latest add sswconsulting/generate-report in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Generate Report safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Generate Report?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Generate Report free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Generate Report?

sswconsulting (@sswconsulting) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Generate Report by sswconsulting — Agent Skill

Name: Generate Report
Author: sswconsulting

Generate Report

One-shot full survey report. Takes one or more CSV/XLSX survey exports (e.g. Microsoft Forms), runs the complete analysis pipeline into a multi-tab HTML dashboard, records the narrated recap video (best-effort), and deploys to surge.sh (or reports the local path when surge isn't logged in). Use when the user wants the complete report from a survey file in a single command, says "generate a report", "full report", or invokes /generate-report.

File contents

generate-report — full report from a survey file, one command

This skill is a thin orchestrator: it runs the two pipeline stages in sequence and reports one combined result. All the real procedure lives in the two skills it invokes — do not duplicate their steps here. On a platform without a skill-invocation tool, read and follow the two sibling SKILL.md files directly (../process-survey/SKILL.md, then ../record-walkthrough/SKILL.md).

/generate-report path/to/survey.xlsx
/generate-report culture.csv worklife.csv focus on burnout

Phase 1 — Analyse + dashboard (required)

Invoke the process-survey skill with the arguments verbatim (file paths + optional focus on …). When running as the installed walrus plugin the skill name is walrus:process-survey; in a clone of this repo it is process-survey.

That skill runs the four analysis agents, consolidation, dashboard render, and deploy. Capture from its output:

the survey slug (the surveys/<slug>/<date>/ folder it created)
the DEPLOYED_URL=… line, or the local dashboard path if deploy was skipped (surge not logged in — one-time npx surge login enables it).

If Phase 1 fails, stop and report — there is nothing to record.

Phase 2 — Recap video (best-effort)

Invoke the record-walkthrough skill (walrus:record-walkthrough as a plugin) with the survey slug from Phase 1. It degrades gracefully:

No ELEVENLABS_API_KEY → captioned silent video (still valid).
No ffmpeg / Playwright Chromium → skip the video entirely, note why.

Voice selection is env-only: LOGBOOK_VOICE (ElevenLabs voice id) — a default voice is used only when it isn't set. Mention the active voice in the report.

A Phase 2 failure never fails the report — the dashboard is already built.

Report

One final summary: dashboard URL (or local index.html path), video status (recorded / captioned / skipped + why), and the headline numbers Phase 1 printed. If a DEPLOYED_URL=… line was produced, echo it verbatim on its own line, nothing else on that line.

---name: generate-reportdescription: One-shot full survey report. Takes one or more CSV/XLSX survey exports (e.g. Microsoft Forms), runs the complete analysis pipeline into a multi-tab HTML dashboard, records the narrated recap video (best-effort), and deploys to surge.sh (or reports the local path when surge isn't logged in). Use when the user wants the complete report from a survey file in a single command, says "generate a report", "full report", or invokes /generate-report.---# generate-report — full report from a survey file, one commandThis skill is a thin orchestrator: it runs the two pipeline stages in sequenceand reports one combined result. All the real procedure lives in the two skillsit invokes — do not duplicate their steps here. On a platform without askill-invocation tool, read and follow the two sibling SKILL.md files directly(`../process-survey/SKILL.md`, then `../record-walkthrough/SKILL.md`).```/generate-report path/to/survey.xlsx/generate-report culture.csv worklife.csv focus on burnout```## Phase 1 — Analyse + dashboard (required)Invoke the **process-survey** skill with the arguments verbatim (file paths +optional `focus on …`). When running as the installed `walrus` plugin the skillname is `walrus:process-survey`; in a clone of this repo it is `process-survey`.That skill runs the four analysis agents, consolidation, dashboard render, anddeploy. Capture from its output:- the survey slug (the `surveys/<slug>/<date>/` folder it created)- the `DEPLOYED_URL=…` line, or the local dashboard path if deploy was skipped (surge not logged in — one-time `npx surge login` enables it).If Phase 1 fails, stop and report — there is nothing to record.## Phase 2 — Recap video (best-effort)Invoke the **record-walkthrough** skill (`walrus:record-walkthrough` as aplugin) with the survey slug from Phase 1. It degrades gracefully:- No `ELEVENLABS_API_KEY` → captioned silent video (still valid).- No ffmpeg / Playwright Chromium → skip the video entirely, note why.Voice selection is env-only: `LOGBOOK_VOICE` (ElevenLabs voice id) — a defaultvoice is used only when it isn't set. Mention the active voice in the report.A Phase 2 failure never fails the report — the dashboard is already built.## ReportOne final summary: dashboard URL (or local `index.html` path), video status(recorded / captioned / skipped + why), and the headline numbers Phase 1printed. If a `DEPLOYED_URL=…` line was produced, echo it verbatim on its ownline, nothing else on that line.

Frequently asked questions