branded-report — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited branded-report (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Generates HTML, PDF, and DOCX from a single Markdown file and a single theme, so a series of reports always looks the same. The agent supplies the content (Markdown) and the cover metadata; the script does the rendering. Deterministic — no LLM is called.
SCRIPT = this skill's scripts/build_report.py. Theme extraction = scripts/extract_theme.py. The theme schema and styling details are in REFERENCE.md.
The look is driven by a small theme.json (colors, fonts, logo, organization). Get one by:
python EXTRACT --template "Brand.pptx" --out theme.json --logo-dir ./assetsWorks with `.pptx`, `.potx`, `.thmx`, `.dotx`, `.docx`, `.xlsx` — anything carrying an OOXML theme. Then open theme.json and pick the right logo (a dark/colored logo for white pages; DOCX needs a PNG/JPG logo via logo_raster — SVG embeds only in HTML/PDF).
extract_theme_visual.pyrenders the source and samples its brand colors (heuristic; review the result):
python VISUAL --image brand.png --out theme.json
python VISUAL --url https://acme.example --out theme.json --logo-dir ./assets # + logo + org + fonts
python VISUAL --pdf branded.pdf --page 1 --out theme.jsonA PDF or image of an already-branded document gives accurate colors; a website yields its on-screen palette + logo to tune. See REFERENCE.md for the reliability notes.
The theme file is organization-specific — keep it local (alongside the user's documents), not in this repo. The skill ships only the neutral theme.example.json.python SCRIPT --input report.md --theme theme.json \
--formats html,pdf,docx --output-dir out --name my-report \
--title "Report title" --subtitle "Subtitle" \
--meta "**Date:** 2026-06-12" --meta "**Author:** ..." \
--footer-note "Confidential" --json| Flag | Meaning |
|---|---|
--input | Markdown source (headings, bold, lists, tables, `` code `, > quotes, ---`) |
--theme | The brand theme JSON (omit for a neutral default theme) |
--formats | Any of html,pdf,docx (default all three) |
--output-dir / --name | Where, and the base filename (default: input stem) |
--title / --subtitle | Cover page (omit --title to skip the cover entirely) |
--meta | A cover metadata line; repeatable. **Label:** renders the label bold |
--footer-note | Small note at the bottom of the cover |
--json | Print a machine-readable {status, outputs} summary |
headings map to the branded section bands, tables and code blocks are styled).
browser found) and offer the HTML (the user can Print-to-PDF from a browser).
browser or open the HTML and print to PDF.
logo is an SVG; Word can't embed SVG. Point logoat a PNG/JPG (or the organization name is used as a text wordmark on the DOCX cover).
pip install markdown python-docx beautifulsoup4 (the repoinstaller does this from skill.install.json).
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.