How do I install the Report skill?

Run npx skillmds@latest add zedarvates/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 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 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 Report free to use?

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

Who published Report?

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

Report by zedarvates — Agent Skill

Name: Report
Author: zedarvates

Report

Persist any audit as a timestamped Markdown and/or HTML file (name + date + time) under .botte/reports/, browsable at any time, and list saved reports. Use when the user wants audits saved to consultable files, a history of audits, or to export a checkup/metrics/infra report as .md or .html.

zedarvates 76b3a82 5 files · 11.2 KB Updated Sep 17, 2026

File contents

report — audits saved as timestamped, consultable files

Audits print to the console; this keeps them. Any report dict → a self-contained <name>_<YYYY-MM-DD_HHMMSS>.md and/or .html under .botte/reports/.

Save an audit

The audit CLIs take --save [md|html|both]:

python -m skills.checkup.cli .        --save both   # checkup_2026-06-20_142838.md/.html
python -m skills.metrics.cli .        --save html
python -m skills.infra_advisor.cli auto . --save md

Browse them any time

python -m skills.report.cli list                # most recent first
python -m skills.report.cli list --json

Programmatic

from skills.report import save, list_reports
save("audit", report_dict, fmt="both", out_dir=project/".botte"/"reports")
list_reports(project/".botte"/"reports")

The renderer handles scalars, lists, list-of-dicts → tables, nested dicts, and ASCII diagram fields as code blocks. .botte/ is gitignored, so reports stay local per machine/project. Exposed via [[llm_mcp]] as list_reports. Related: [[checkup]], [[metrics]], [[infra_advisor]], [[app_test]] (its own HTML report).

Frequently asked questions