audit-run

Executes one audit from the A-01 to A-22 programme and releases reproducible Markdown and PDF reports.

Updated Apr 16, 2026
One-click install
npx skills add https://github.com/real-case/marvin-toolkit --skill audit-run-real-case
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-run
Source: https://github.com/real-case/marvin-toolkit/tree/main/plugins/marvin/skills/audit-run
Command: npx skills add https://github.com/real-case/marvin-toolkit --skill audit-run-real-case

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires reportlab, pypdf, and includes references (resource) components.

What problem does it solve? Running a rigorous, evidence-based audit of a software project usually requires assembling methodology, evidence rules, severity scales, and report formats from scratch, and results are rarely reproducible or comparable across audits. This Skill executes a single audit from a formal 22-audit programme (dependencies, tests, security, CI/CD, data model, and more) end to end, producing a standardized report with a machine-readable findings register. ## Core Features & Use Cases - Single-audit execution: Resolves the requested audit (e.g., A-07 tests, A-14 security) from the audit index, loads its specification and the shared report contract, and collects evidence under a declared sampling budget. - Reproducible reporting: Freezes the commit SHA and tool versions, records derived parameters, and emits a seven-section report in Markdown plus PDF with a verified json findings register. - Strict read-only safety: Never modifies the audited repository, never prints secrets, treats repository text as untrusted data, and immediately reports any live credential discovered. - Use Case: Ask to "audit the data model" and receive a ranked findings register with file:line evidence, severity scores S0-S4, coverage and confidence metrics, and both .md and .pdf report files. ## Quick Start Ask the assistant to run one audit from the programme, for example: run audit A-07 on the test suite of this repository and produce the report.

Frequently Asked Questions about audit-run

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a single project audit like a dependency or test audit?▼

Name the audit subject or its identifier, such as "audit the data model" or "A-07". The skill resolves the request to exactly one audit in the A-01 to A-22 index, loads its specification, collects evidence, and produces a report.

What audits are included in the A-01 to A-22 programme?▼

The programme covers system inventory, onboarding, dependencies, repository history, static analysis, type safety, tests, development process, module boundaries, data model, API contracts, integrations, frontend architecture, security, performance, observability, CI/CD, reliability, cost, documentation, accessibility, and privacy.

Does the audit modify my repository or install dependencies?▼

No. The audit is strictly read-only: it never edits, commits, branches, or installs packages into the audited project. The only writes are the two report files under the output directory, plus optional tooling in a temporary directory outside the repository.

What output does an audit run produce?▼

Each run produces a Markdown report and a rendered PDF sharing the same content, plus a machine-readable JSON findings register with severity, confidence, category, effort, and evidence fields. A verifier checks that finding identifiers match across prose, register, and PDF before release.

What happens if a prerequisite audit report is missing?▼

The audit still runs. It derives what it can, records the missing input in the Limits of confidence section, and lowers the confidence rating accordingly rather than refusing to start.

What happens when the audit finds a live credential in the repository?▼

The run stops and reports the discovery immediately in the next message, giving the path, the credential type, and the fact of discovery, never the value. It then continues the audit and files the finding as severity S0.