report-writing-skills
Agent skills for planning, drafting, copyediting, reviewing and presenting technical reports (AsciiDoc, reveal.js, PlantUML). Based on Hering's How to Write Technical and Scientific Reports.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/larsw--report-writing-skills)HTML
<a href="/listings/larsw--report-writing-skills"><img src="/api/listings/larsw--report-writing-skills/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
The repository is at the same time an Agent Skills collection, an [Agent Plugins](https://agent-plugins.org) 1.0 plugin, a Claude Code plugin marketplace and a Gemini CLI extension, so most agents can install it directly from GitHub. Install all five skills together: they mention each other and the outline/drafting skills use the review skill's linter when it is present.
Any agent with Agent Skills support (40+ agents)
npx skills add larsw/report-writing-skills # project scope; add -g for user scope npx skills add larsw/report-writing-skills -a codex # pick agents with -a (claude-code, codex, cursor, github-copilot, gemini-cli, opencode, windsurf, …)
The [`skills` CLI](https://github.com/vercel-labs/skills) detects installed agents and copies `skills/*` into each agent's skills directory.
Claude Code
/plugin marketplace add larsw/report-writing-skills /plugin install report-writing@report-writing-skills
Codex, Cursor, GitHub Copilot, Kiro, VS Code (Agent Plugins)
The root [`plugin.json`](plugin.json) is an Agent Plugins 1.0 manifest with the skills in `skills/`.
npx plugins add larsw/report-writing-skills # installs into the detected clients copilot plugin install larsw/report-writing-skills # GitHub Copilot CLI, directly from the repo
Or use the client's own plugin installer with the GitHub URL `https://github.com/larsw/report-writing-skills`.
Gemini CLI
gemini extensions install https://github.com/larsw/report-writing-skills
Claude.ai and Claude Desktop
Download the zip files from the [latest release](https://github.com/larsw/report-writing-skills/releases/latest) and upload each one under **Settings → Capabilities → Skills**. Each zip holds one skill folder; `report-writing-skills.zip` holds all five. Build them yourself with `python3 scripts/build_dist.py`.
Manual
Copy or symlink the folders in `skills/` into your agent's skills directory:
| Agent | Project scope | User scope | |---|---|---| | Claude Code | `.claude/skills/` | `~/.claude/skills/` | | Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Amp, Cline, Zed | `.agents/skills/` | Codex `~/.agents/skills/`, Cursor `~/.cursor/skills/`, Copilot `~/.copilot/skills/`, Gemini `~/.gemini/skills/`, OpenCode `~/.config/opencode/skills/` | | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` | | Goose | `.goose/skills/` | `~/.config/goose/skills/` | | Kiro | `.kiro/skills/` | `~/.kiro/skills/` | | Roo Code | `.roo/skills/` | `~/.roo/skills/` |
git clone https://github.com/larsw/report-writing-skills.git ln -s "$PWD"/report-writing-skills/skills/* ~/.claude/skills/
Agents without skill support
Clone the repository and add this to the agent's instruction file (`AGENTS.md`, rules file, custom instructions):
For planning, drafting, copyediting, reviewing or presenting technical reports, read and follow the matching skill before starting: <path>/skills/report-outline/SKILL.md, report-drafting, report-copyedit, report-review, report-presentation (same layout). Load files under a skill's references/ only when the SKILL.md points to them.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 15 lines
- {
- "name": "report-writing-skills",
- "owner": {
- "name": "Lars Wilhelmsen",
- "url": "https://github.com/larsw"
- },
- "plugins": [
- {
- "name": "report-writing",
- "source": "./",
- "description": "Plan, draft, copyedit, review and present technical reports",
- "version": "0.2.0"
- }
- ]
- }
README.md · README · 124 lines
- # report-writing-skills
- Five [Agent Skills](https://agentskills.io) for planning, drafting, copyediting, reviewing and presenting technical and scientific reports. They follow the method in Heike Hering's *How to Write Technical and Scientific Reports: Understandable Structure, Good Design, Convincing Presentation* (3rd ed., Springer 2025): the rules are paraphrased, adapted to current international practice, and turned into workflows, checklists and two small checking scripts.
- They work with plain prose, Markdown and extracted PDF text, and know **AsciiDoc/Asciidoctor**, **LaTeX** (siunitx, biblatex, cleveref, pgfplots), **asciidoctor-reveal.js**, **Beamer** and **PlantUML** in detail.
- | Skill | Use it to |
- |---|---|
- | [`report-outline`](skills/report-outline/SKILL.md) | analyze the task, find a title, build core message → 4-point → 10-point → detailed outline, pick a structure pattern (lab, design, project, thesis, IMRaD, decision report, manual), set up a style sheet and an AsciiDoc or LaTeX skeleton; check an outline's logic |
- | [`report-drafting`](skills/report-drafting/SKILL.md) | write sections (introduction, methods, results, summary, …), figures and PlantUML diagrams, tables and weighted evaluation matrices, formulas and computations, citations; never invents data, marks gaps instead |
- | [`report-copyedit`](skills/report-copyedit/SKILL.md) | light or medium line edit for clarity, one term per thing, notation and units, without changing content; leaves `###AQ` author queries |
- | [`report-review`](skills/report-review/SKILL.md) | pre-submission review: AsciiDoc/LaTeX linter + fictive-reader read + report checklist → "fix first" list and findings by severity |
- | [`report-presentation`](skills/report-presentation/SKILL.md) | turn a report into a talk and a reveal.js or Beamer deck, review slides, plan timing, rehearsal and Q&A, short statements |
- ## Install
- The repository is at the same time an Agent Skills collection, an [Agent Plugins](https://agent-plugins.org) 1.0 plugin, a Claude Code plugin marketplace and a Gemini CLI extension, so most agents can install it directly from GitHub. Install all five skills together: they mention each other and the outline/drafting skills use the review skill's linter when it is present.
- ### Any agent with Agent Skills support (40+ agents)
- ```sh
- npx skills add larsw/report-writing-skills # project scope; add -g for user scope
- npx skills add larsw/report-writing-skills -a codex # pick agents with -a (claude-code, codex, cursor, github-copilot, gemini-cli, opencode, windsurf, …)
- ```
- The [`skills` CLI](https://github.com/vercel-labs/skills) detects installed agents and copies `skills/*` into each agent's skills directory.
- ### Claude Code
- ```
- /plugin marketplace add larsw/report-writing-skills
- /plugin install report-writing@report-writing-skills
- ```
- ### Codex, Cursor, GitHub Copilot, Kiro, VS Code (Agent Plugins)
- The root [`plugin.json`](plugin.json) is an Agent Plugins 1.0 manifest with the skills in `skills/`.
- ```sh
- npx plugins add larsw/report-writing-skills # installs into the detected clients
- copilot plugin install larsw/report-writing-skills # GitHub Copilot CLI, directly from the repo
- ```
- Or use the client's own plugin installer with the GitHub URL `https://github.com/larsw/report-writing-skills`.
- ### Gemini CLI
- ```sh
- gemini extensions install https://github.com/larsw/report-writing-skills
- ```
- ### Claude.ai and Claude Desktop
- Download the zip files from the [latest release](https://github.com/larsw/report-writing-skills/releases/latest) and upload each one under **Settings → Capabilities → Skills**. Each zip holds one skill folder; `report-writing-skills.zip` holds all five. Build them yourself with `python3 scripts/build_dist.py`.
- ### Manual
- Copy or symlink the folders in `skills/` into your agent's skills directory:
- | Agent | Project scope | User scope |
- |---|---|---|
- | Claude Code | `.claude/skills/` | `~/.claude/skills/` |
- | Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Amp, Cline, Zed | `.agents/skills/` | Codex `~/.agents/skills/`, Cursor `~/.cursor/skills/`, Copilot `~/.copilot/skills/`, Gemini `~/.gemini/skills/`, OpenCode `~/.config/opencode/skills/` |
- | Windsurf | `.windsurf/skills/` | `~/.codeium/windsurf/skills/` |
- | Goose | `.goose/skills/` | `~/.config/goose/skills/` |
- | Kiro | `.kiro/skills/` | `~/.kiro/skills/` |
- | Roo Code | `.roo/skills/` | `~/.roo/skills/` |
- ```sh
- git clone https://github.com/larsw/report-writing-skills.git
- ln -s "$PWD"/report-writing-skills/skills/* ~/.claude/skills/
- ```
- ### Agents without skill support
- Clone the repository and add this to the agent's instruction file (`AGENTS.md`, rules file, custom instructions):
- ```markdown
- For planning, drafting, copyediting, reviewing or presenting technical reports, read and follow the
- matching skill before starting: <path>/skills/report-outline/SKILL.md, report-drafting, report-copyedit,
- report-review, report-presentation (same layout). Load files under a skill's references/ only when the
- SKILL.md points to them.
- ```
- ## Bundled scripts
- Both are stdlib-only Python 3 and follow `include::` and `\input`/`\include`.
- ```sh
- # AsciiDoc or LaTeX report: xrefs, citations vs .bib, captions and their position, labels/IDs,
- # \label before \caption, distorted images, lone subsections, heading form, intro sentences,
- # number–unit spacing, ranges, abbreviations, long sentences, open ### / TODO / \todo markers,
- # headings swallowed by missing blank lines (AsciiDoc)
- python3 skills/report-review/scripts/lint_report.py report.adoc [--json] [--known-abbrev FEM,CAD]
- python3 skills/report-review/scripts/lint_report.py main.tex
- # reveal.js (AsciiDoc) or Beamer deck: per-slide words, elements, notes, label headings,
- # thank-you slides, backup slides, speaking time from the speaker notes
- python3 skills/report-presentation/scripts/deck_stats.py deck.adoc --minutes 20
- python3 skills/report-presentation/scripts/deck_stats.py talk.tex --minutes 20
- ```
- ## Conventions
- The venue (university, company, customer, journal) always wins; the book's rules are the default where the venue is silent. Where the book conflicts with current international practice, the skills say so and default as follows:
- - Ranges with units: ISO 80000 / SI form ("160 °C to 200 °C" or "(160 to 200) °C").
- - Voice: the book's impersonal default for traditional engineering reports; active voice and "we" where the venue prefers it. The actor must always be clear.
- - Decimal point, true minus sign, en dash for ranges, 300 dpi for print, vector formats for diagrams.
- - German-specific items (DIN standards, declaration in lieu of an oath, decimal comma) are generalized.
- ## Development
- ```sh
- python3 scripts/check.py # frontmatter, vendored copies, manifest versions, script smoke tests
- python3 scripts/check.py --fix # re-copy vendored reference files
- python3 scripts/build_dist.py # dist/*.zip for archive-based installs
- ```
- Each skill has test cases under `skills/<skill>/evals/` in the `claude plugin eval` layout (`cd skills/<skill> && claude plugin eval . --allow-tools Write,Edit,Bash --scaffold`). Keep the versions in `plugin.json`, `.claude-plugin/plugin.json`, `.claude-plugin/marketplace.json` and `gemini-extension.json` equal.
- ## License
- [Apache License 2.0](LICENSE). See [NOTICE](NOTICE) for attribution. Not affiliated with or endorsed by the book's author or publisher.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.