1
    🪪 Repo Card

    🪪 Repo Card

    by JustHandled Labs

    Generate a shareable stat card for any repo, with an honest health grade. It reads the file tree and renders a card showing the language mix, file count and size, whether tests, docs, and a license are present, and an A-to-F health grade from a documented rubric. Markdown by default, SVG with a flag. The kind of card people actually post.

    Updated Jun 2026
    Security scanned
    Cursor

    $9

    · or 45 credits

    30-day refund guarantee

    Secure checkout via Stripe

    Included in download

    • Audit repository health before a project handoff or release
    • Generate visual status cards for project documentation and READMEs
    • terminal, file_read, file_write automation included
    • Ready for Cursor
    • Instant install

    Sample input

    Grade my current repository and generate a Markdown stat card for it.

    Sample output

    📊 Repo Health Card: auth-service

    Grade: A-

    • Languages: TypeScript (82%), Bash (18%)
    • Lines of Code: 4,250
    • Tests: ✅ Detected (/tests)
    • Docs: ✅ README.md found
    • License: ✅ MIT
    • Status: Healthy. Consider adding a CONTRIBUTING.md.

    About This Skill

    Quantify Your Repository Health

    Repo Card is a specialized developer tool that analyzes local codebases to generate high-quality, shareable status cards. It solves the problem of manual repository auditing by providing an instant, heuristic "Health Grade" based on established engineering rubrics. Whether you are prepping a project for handoff, auditing a legacy codebase, or showcasing a new open-source tool, Repo Card automates the documentation of project vitality.

    What it does

    • Static Analysis: Scans local directories to detect language distribution, codebase size, and architectural completeness.
    • Vital Sign Detection: Automatically identifies the presence of testing suites, comprehensive documentation, and licensing.
    • Heuristic Grading: Applies a standardized rubric to assign a project health grade (A-F).
    • Multi-Format Export: Generates output in clean Markdown for READMEs or SVG for visual dashboards.

    Why use this skill?

    Unlike basic AI prompting, Repo Card follows a strict, safe workflow that avoids common pitfalls like hallucinating file structures or attempting to run untrusted code. It operates entirely on local static signals, ensuring zero network calls and total privacy for your source code. You get a consistent, professional-grade visual summary in seconds—a task that would take a developer 15-20 minutes of manual checking and formatting.

    Use Cases

    • Audit repository health before a project handoff or release
    • Generate visual status cards for project documentation and READMEs
    • Quickly assess the test and doc coverage of unfamiliar codebases
    • Create a language and size breakdown of any local directory

    Reviews

    No reviews yet - be the first to share your experience.

    Only users who have downloaded or purchased this skill can leave a review.

    Security Scanned

    Passed automated security review

    Permissions

    Terminal / Shell
    Read Files
    Write Files

    Allowed Hosts

    www.w3.org

    File Scopes

    repo-card/**
    --write

    Notes: Prints a Markdown card to stdout by default; --svg renders an SVG card. Reads no environment variables and runs no code from the repo.

    Works with any agent that can read a repo and run a local Python script (Claude Code, Cursor, Codex CLI, and other SKILL.md-compatible agents). Standard library only, no install step. It reads the file tree statically; it does not run the code or call the network.

    Creator

    JustHandled Labs builds focused agent skills for the work nobody wants to do by hand. Each one is a single repeatable job done well: catching the security and data mistakes that quietly ship, keeping docs and tests honest, gating the commands an agent is about to run, sharpening writing, and handling the founder chores around launches, outreach, and brand setup. Not generic AI productivity. Specific workflows that are easy to run, review, and repeat. Maintained by H.J. Westerfield, with a background in communications, editing, project coordination, customer support, and practical AI systems. Tools for people who want useful automation without theatrical complexity.

    Frequently Asked Questions

    More Premium Skills

    $9