REPOSITORY ASSESSMENT / GitHub community
AgentRC readiness report renderer
Turns actual AgentRC assessment JSON and repository context into a static HTML report with policy-aware findings and remediation priorities.
“Runs the AgentRC readiness assessment on the current repository and produces a self-contained, static HTML dashboard at reports/index.html. Explains every readiness pillar, the maturity level, and an actionable remediation plan, framed by AgentRC measure → generate → maintain loop. Use when asked to assess, audit, score, report on, or visualise the AI readiness of a repo.”
01 / THE REASONING
Why this made the selection.
- It requires real JSON input and retains that input in the report for inspection.
- Policy-disabled criteria and non-scoring extras are distinguished from scored gaps.
- The reporter is told to run agentrc readiness with JSON output and never to fabricate the readiness data.
- It may write only reports/index.html, and that HTML is required to open from disk with no external network assets.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- agents/ai-readiness-reporter.agent.md (complete definition)
- LICENSE (applicable redistribution terms)
- Host custom-agent documentation; repository installation guidance where applicable
- skills/acreadiness-assess/SKILL.md (complete); report-template.html dependency identity
Our findings
- The companion acreadiness-assess skill supplies the report-template.html dependency and names Node 20+ as a prerequisite.
- The agent limits its intended file output to reports/index.html and specifies escaping for HTML and embedded JSON substitutions.
- The workflow runs agentrc readiness --json, interprets pillars, and writes a single self-contained reports/index.html.
- Declared tools are execute, read, search, search/codebase, and editFiles. The report itself must not load external CSS, fonts, or scripts.
- The file says never to fabricate readiness data, never to let extras affect the result, and never to write any file except reports/index.html.
- It names two template locations: the acreadiness-assess skill folder, and the plugin root. It also says to escape substituted values before they enter HTML.
Not established by this review
- No agent was installed or invoked. Host/model compatibility, task accuracy and runtime behaviour were not tested.
- The resource was not executed and its tools were not called.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
- Read the pinned definition and MIT licence; review the host permissions before use.
- Obtain the complete acreadiness-assess context and template, review a pinned AgentRC installation, then pass observed assessment output for rendering in a scoped reports directory.
- Provide an authorized repository, any AgentRC policy and actual readiness assessment JSON or an approved CLI execution environment.
Before you start
- Copilot and supported execution/edit tools
- Node/toolchain matching the reviewed AgentRC release
- The sibling assessment skill, template and an explicit policy if required
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/agents/ai-readiness-reporter.agent.md
Supports: Workflow, inputs and outputs, Declared tools and constraints, Selection and limitations
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/LICENSE
Supports: Licence and attribution requirements
https://docs.github.com/en/copilot/reference/custom-agents-configuration
Supports: Host setup and permission defaults
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/skills/acreadiness-assess/SKILL.md
Supports: Prerequisites, scan and renderer handoff
- Required report template ↗Checked
https://github.com/github/awesome-copilot/blob/f25421d3f1b8b3bb217f78a7c0567cf7ec117cd8/skills/acreadiness-assess/report-template.html
Supports: Required sibling asset