Agent skill

GitHub Repo

by jdevalk in jdevalk/skills

Audits and improves GitHub repository quality — README structure, community health files, .github directory setup, issue/PR templates, metadata, releases, and branch hygiene.

MITAuto-check passedDevelopment

Install GitHub Repo

skills CLI
$ npx skills add jdevalk/skills --skill github-repo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jdevalk/skills github-repo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jdevalk/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/github-repo .claude/skills/github-repo && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
github-repo
GitHub stars
104
Token cost
~1.5k tokens
SKILL.md length
661 words
Files
4
Skills in repo
9
Repo updated
First seen
Licence
MIT

At a glance

Audits and improves GitHub repository quality — README structure, community health files, .github directory setup, issue/PR templates, metadata, releases, and branch hygiene.

  • Works in 5 steps: Gather Context → Audit → Generate or Improve Files → …
  • The user asks to improve
  • SKILL.md covers Workflow, Phase 0: Gather Context, Phase 1: Audit and Phase 2: Generate or Improve…, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

GitHub Repo is an agent skill from jdevalk/skills. Audits and improves GitHub repository quality — README structure, community health files, .github directory setup, issue/PR templates, metadata, releases, and branch hygiene. Use this skill whenever the user asks to improve, audit, review, or set up a GitHub repository, or when they mention things like "make my repo look professional", "add contributing guidelines", "set up issue templates", "improve my README", "clean up my repo", "prepare my repo for open source", or "make my GitHub project look good". Also…

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `AGENTS.md`, `README.md` and `evals/evals.json`).

It sits in Development, covering Open source maintenance, Technical documentation and Policy and terms drafting. It works with GitHub and Git. The repository describes itself as: Agent skills for GitHub repos and profiles, WordPress and EmDash plugins, Astro SEO, and content readability. The licence is MIT.

When your agent uses it

  • The user asks to improve
  • Set up a GitHub repository
  • They mention things like make my repo look professional
  • Add contributing guidelines

Example prompts

  • “make my repo look professional”
  • “add contributing guidelines”
  • “set up issue templates”
  • “/github-repo”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Gather Context
  2. Audit
  3. Generate or Improve Files
  4. 5: Metadata and readability pass
  5. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit 106fc68. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

GitHub Repo loads about 1.5k tokens when it runs. Until then it costs about 208 tokens; SKILL.md has 661 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~208
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jdevalk/skills at commit 106fc68, republished under its MIT licence (© jdevalk). 661 words, ~1,498 tokens.

Download SKILL.mdSave it as .claude/skills/github-repo/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
github-repo
description
Audits and improves GitHub repository quality — README structure, community health files, .github directory setup, issue/PR templates, metadata, releases, and branch hygiene. Use this skill whenever the user asks to improve, audit, review, or set up a GitHub repository, or when they mention things like "make my repo look professional", "add contributing guidelines", "set up issue templates", "improve my README", "clean up my repo", "prepare my repo for open source", or "make my GitHub project look good". Also trigger when working inside a git repository and the user asks about best practices for documentation, community files, or repository structure. If the user is in a repo directory and mentions README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT, LICENSE, .github, templates, or release tags, use this skill.

GitHub Repository Optimizer

This skill audits a GitHub repository against best practices and generates or improves the files that make a repo look professional, welcoming, and well-maintained. It works with live repos (via gh CLI), local git directories, or files the user provides.

Implementation recipes live in AGENTS.md — read it when you need to generate or improve specific files. This file has the workflow and audit checklist.

Workflow

  1. Gather repo context — Determine what we're working with and collect information
  2. Run the audit — Score every aspect of the repo's public-facing quality
  3. Generate or improve files — Produce the files that are missing or need work. Recipes are in AGENTS.md.
  4. Metadata and readability pass — invoke metadata-check on the repo description and README blurb; readability-check on prose-heavy files.
  5. Verify — Confirm the outputs are correct and complete

Phase 0: Gather Context

Key information to collect: repo name, description, language/framework, README existence and quality, which community health files exist, issue/PR template status, CI/CD status, release history, branch count. Use gh CLI if authenticated, otherwise read local files.


Phase 1: Audit

Score each category out of 10. For each, give 2–4 specific findings that quote the actual state.

README Quality (x/10)

Does the README exist? Is it well-structured with: project name and clear one-liner, badge row (build/license/version), description explaining what/why/who, quick start (install + first use in 3 steps or fewer), code examples, screenshots/demos if visual, configuration docs, contributing link, license mention? Is it under 500 lines with <details> for optional content?

Repository Metadata (x/10)
  • Description set and useful (not blank or "My awesome project")?
  • Topics/tags relevant and complete?
  • Website URL set if applicable?
  • Social preview image uploaded?
  • "Packages", "Environments", "Deployments" sections hidden if unused?
Community Health Files (x/10)
  • CONTRIBUTING.md — exists? Covers dev setup, code style, testing, PR process?
  • SECURITY.md — exists? Directs to private reporting channel, states response time?
  • CODE_OF_CONDUCT.md — exists? Contributor Covenant 2.1 is the standard.
  • LICENSE — exists in root? Appropriate for project type?
  • SUPPORT.md — exists? Separates bugs from support questions?
  • CHANGELOG.md — follows Keep a Changelog format?

For organizations: check for a .github repository with org-wide default health files.

Issue & PR Templates (x/10)
  • YAML-based issue forms (.github/ISSUE_TEMPLATE/*.yml) with at least bug report and feature request? Numbered filenames for ordering?
  • config.yml disabling blank issues and linking external support?
  • PR template with description, related issues (Closes #XXX), type-of-change checkboxes, testing checklist?
  • CODEOWNERS file defining reviewers per directory?
Show full SKILL.md (268 more words)Show less
CI/CD & Automation (x/10)
  • GitHub Actions workflows for testing, linting, building? Passing status badges in README?
  • Dependabot or Renovate configured?
  • Code quality (CodeQL, linting actions)?
  • Stale issue management?
Releases & Branch Hygiene (x/10)
  • Tagged releases with changelogs? Semantic versioning?
  • Stale branches cleaned up?
  • .gitattributes with export-ignore?
  • Auto-release (semantic-release or release-please)?

Phase 2: Generate or Improve Files

Based on the audit, generate the files that are missing or need improvement. Always ask before overwriting. Read AGENTS.md for detailed recipes.

File generation order by impact: README.md, LICENSE, CONTRIBUTING.md, SECURITY.md, CODE_OF_CONDUCT.md, issue templates, PR template, CHANGELOG.md, SUPPORT.md, config files (dependabot.yml, CODEOWNERS, FUNDING.yml).

AGENTS.md sections: README generation, Community health files (CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), Issue templates, Organization-level setup (.github repo, org profile, private member profile, domain verification, rulesets).


Phase 2.5: Metadata and readability pass

  1. Metadata pass — metadata-check skill. Run on the repo description (first ~100 chars show in search and profile cards) and the README's opening blurb.
  2. Prose pass — readability-check skill. Run on every prose-heavy file — at minimum the README, plus CONTRIBUTING.md and SECURITY.md if you produced them.

Apply fixes directly. Skip for code-heavy files (issue templates, workflow YAML).


Phase 3: Verify

  • Verify files are in the correct locations.
  • Check that all internal links in the README work.
  • Confirm badge URLs are correctly formatted.
  • If gh is available, remind the user to update the repo's About section (description, topics, website URL, social preview) — these can't be set via files alone.
  • Summarize what was created/changed and what the user should do next.

Output format

Score table (6 categories, x/60), grouped findings quoting actual state, list of files generated/changed, and next steps for the user.

© jdevalk, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files in github-repo of jdevalk/skills.

  • SKILL.md
  • AGENTS.md
  • README.md
  • evals/evals.json

Open the folder on GitHubat commit 106fc68

Compare with similar skills

GitHub Repo next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

GitHub Repo compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
GitHub Repo this skilljdevalk/skills104—~1.5kAutomated safety check: PassMIT
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Mole Release Notes Publishertw93/Mole69k—~1.9kAutomated safety check: PassGPL-3.0
Pre-Release PR Triagejamiepine/voicebox57k—~3.1kAutomated safety check: PassMIT
Ansible Backport Creatoransible/ansible71k—~1.2kAutomated safety check: PassGPL-3.0
RTK Issue Triagertk-ai/rtk83k—~3kAutomated safety check: NotesApache-2.0

Similar skills

  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Publishes curated, bilingual release notes for an existing Mole version tag with gh release edit, including contributor thanks and reactions, after the release workflow finishes.

    69k GitHub stars~1.9k tokensUpdated today
    DevelopmentAuto-check passed
  • Pre-Release PR Triage

    jamiepine/voicebox

    Sorts a backlog of open pull requests into must-merge, candidate, superseded and deferred, writes a triage doc and works the merge loop before a release.

    57k GitHub stars~3.1k tokensUpdated today
    DevelopmentAuto-check passed
  • Creates backports of a merged Ansible devel pull request onto the right stable branches by cherry-picking its merge commit onto new backport branches.

    71k GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • Audits open GitHub issues, categorizes them, flags duplicates and linked PRs in three phases, with optional deep analysis and comments posted only after validation.

    83k GitHub stars~3k tokensUpdated today
    DevelopmentAuto-check: notes
  • Official

    Walks a repository through release readiness before it goes public: secrets audit, licensing, documentation, CI and language-specific packaging.

    7.4k GitHub stars~2.6k tokensUpdated 5 days ago
    DevelopmentAuto-check passed

More from jdevalk/skills

All 9 skills in this repo
  • Wp Static Clone

    jdevalk/skills

    Clones a live WordPress (or other CMS-driven) site into a static HTML site deployable on any static host (Cloudflare Pages, Netlify, Vercel, S3+CloudFront, plain Apache/nginx).

    104 GitHub stars~2.6k tokensUpdated 3 mo ago
    Auto-check passed
  • Astro SEO

    jdevalk/skills

    Audits and improves SEO for Astro sites. An agent skill from jdevalk/skills.

    104 GitHub stars~4.9k tokensUpdated 3 mo ago
    Auto-check passed
  • Content SEO

    jdevalk/skills

    Audits a blog post draft or page copy for content-level SEO: search intent fit, focus keyphrase placement, E-E-A-T signals (experience, expertise, authoritativeness, trustworthiness), helpfulness…

    104 GitHub stars~2.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Metadata Check

    jdevalk/skills

    Reviews short high-value strings — page titles, meta descriptions, schema description fields, FAQ answers, GitHub repo taglines, profile bios, social-card copy, and other metadata where Flesch and…

    104 GitHub stars~1k tokensUpdated 3 mo ago
    Auto-check passed
  • Readability Check

    jdevalk/skills

    Runs a readability audit on a blog post draft or other multi-paragraph prose, calibrated for readers who read English as a second language.

    104 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Static SEO

    jdevalk/skills

    Audits and improves SEO for static HTML sites. An agent skill from jdevalk/skills.

    104 GitHub stars~4.8k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Categories

Questions about GitHub Repo

What does GitHub Repo do?

Audits and improves GitHub repository quality — README structure, community health files, .github directory setup, issue/PR templates, metadata, releases, and branch hygiene. GitHub Repo is an agent skill from jdevalk/skills.github directory setup, issue/PR templates, metadata, releases, and branch hygiene.

When should I use GitHub Repo?

GitHub Repo fits situations like: the user asks to improve; set up a GitHub repository; they mention things like make my repo look professional; add contributing guidelines.

How do I install GitHub Repo in Claude Code?

Run `npx skills add jdevalk/skills --skill github-repo -a claude-code`. Or copy the skill folder (github-repo in jdevalk/skills) into .claude/skills/github-repo in your project. Claude Code loads it when a task matches its description.

How do I install GitHub Repo in Codex?

Run `npx skills add jdevalk/skills --skill github-repo -a codex`. Or copy the skill folder (github-repo in jdevalk/skills) into .agents/skills/github-repo in your project. Codex loads it when a task matches its description.

Can I use GitHub Repo in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jdevalk/skills --skill github-repo -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/github-repo, .gemini/skills/github-repo, .github/skills/github-repo and .opencode/skills/github-repo in your project.

What does GitHub Repo need to run?

SKILL.md names no scripts, command-line tools or credentials: GitHub Repo is instructions for the agent only.

Does GitHub Repo access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is GitHub Repo safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does GitHub Repo use?

GitHub Repo is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does GitHub Repo use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to GitHub Repo?

Skills that share tags, products or a category with GitHub Repo: Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars), Mole Release Notes Publisher (tw93/Mole, 69k stars), Pre-Release PR Triage (jamiepine/voicebox, 57k stars) and Ansible Backport Creator (ansible/ansible, 71k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains GitHub Repo?

jdevalk (a GitHub user) maintains it in jdevalk/skills, which has 104 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on July 5, 2026.

Source: jdevalk/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.