readme-metrics-dashboard
Generates repo metrics dashboards and updates README files with reproducible chart examples.
Install
mkdir -p .claude/skills/readme-metrics-dashboard && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10261" && unzip -o skill.zip -d .claude/skills/readme-metrics-dashboard && rm skill.zipInstalls to .claude/skills/readme-metrics-dashboard
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Refresh repository metrics, render a full chart dashboard (line, bar, area, pie, scatter, composed), and update README with a reproducible example.Key capabilities
- →Generate metrics JSON
- →Render chart dashboards
- →Update README with metrics
- →Visualize repository health
How it works
It runs scripts to generate metrics, renders charts using a CDN-based React environment, and updates the README with reproducible examples.
Inputs & outputs
When to use readme-metrics-dashboard
- →Update repository metrics
- →Generate project health charts
- →Add metrics dashboard to README
About this skill
README Metrics Dashboard Skill
Use When
- The user asks to update README examples
- The user asks for project metrics dashboard updates
- The user asks for language/tech stack summaries with charts
Required Workflow
-
Generate fresh metrics JSON:
- Run: npm run metrics:repo:write
- Source script: scripts/repo-metrics.cjs
- Output file: doc/repo-metrics.json
-
Regenerate the dashboard screenshot:
- Run: npm run metrics:screenshot
- Source script: scripts/screenshot-chart-dashboard.cjs
- Output file: doc/screenshots/chart-grid.png
- Requires internet access (loads React 18 + react-is from jsdelivr CDN at render time)
-
Build dashboard data from doc/repo-metrics.json using all chart types:
- line: trend-style comparison across ranked language buckets
- bar: lines per language
- area: cumulative lines by language rank
- pie: file share by language
- scatter: files vs lines per language
- composed: files (bar) + lines (line) per language
-
Display dashboard in chat by calling display_chart with:
- charts[] containing all six chart types
- title set to a repository metrics heading
- layout set to grid when possible
-
Update README with a reusable example section that includes:
- One command block showing how to regenerate metrics JSON
- One tool payload example for display_chart using the generated metrics
- Short note that metrics are snapshot-based and should be regenerated before releases
Validation Checklist
- Ensure all six chart types are present in the payload
- Ensure README example references doc/repo-metrics.json
- Ensure command names match package.json scripts
- Keep the README example deterministic and copy-paste ready
When not to use it
- →Non-repository metrics tasks
Prerequisites
Limitations
- →Requires internet access for chart rendering
- →Metrics are snapshot-based
How it compares
It automates the entire lifecycle of metrics visualization from data collection to documentation updates.
Compared to similar skills
readme-metrics-dashboard side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| readme-metrics-dashboard (this skill) | 0 | 4mo | No flags | Beginner |
| MinerU Document Extractor | 0 | 3mo | Review | Intermediate |
| memory-transform | 0 | 3mo | Review | Intermediate |
| ml-paper-writing | 48 | 6mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
MinerU Document Extractor
opendatalab
>
memory-transform
fahad0001
Agent memory transformation skill. Converts the indexed agent memory into navigable representations including Obsidian vaults with backlinks, Mermaid dependency and status graphs, Graphviz DOT files, and static dashboards. Use when the user wants to visualize requirements, browse memory in Obsidian,
ml-paper-writing
davila7
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.
docs-review
metabase
Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.
claude-md-improver
anthropics
Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".
markdown-to-html
github
Convert Markdown files to HTML similar to `marked.js`, `pandoc`, `gomarkdown/markdown`, or similar tools; or writing custom script to convert markdown to html and/or working on web template systems like `jekyll/jekyll`, `gohugoio/hugo`, or similar web templating systems that utilize markdown documents, converting them to html. Use when asked to "convert markdown to html", "transform md to html", "render markdown", "generate html from markdown", or when working with .md files and/or web a templating system that converts markdown to HTML output. Supports CLI and Node.js workflows with GFM, CommonMark, and standard Markdown flavors.