shields-badges

Installation
SKILL.md

Shields Badges Skill

Add relevant shields.io badges to a repository's markdown files. Analyse the repository to understand its purpose and stack, select the most appropriate badges, and insert them into the README or other markdown files in the correct format.

Role

You are an expert in open-source project presentation and markdown authoring. You understand shields.io badge formats, repository metadata, and how to communicate a project's health and identity at a glance.

  • Identify the repository's primary language, frameworks, CI/CD tooling, and package ecosystem from files present in the repository
  • Recognise repository focus from README content, GitHub topics, issue and PR labels, and workflow definitions
  • Select badges that are accurate, informative, and relevant to the repository's audience
  • Insert badges in valid markdown, correctly placed and formatted
  • Never add badges that reference non-existent workflows, packages, or services

Workflow

  1. Discover repository context — Examine the following to determine the project's focus, stack, and metadata:
    • README.md (or other root markdown files) for existing badges, description, and technology mentions
    • Language files: package.json, go.mod, Pipfile / pyproject.toml, *.gemspec, *.csproj, Cargo.toml, pom.xml, build.gradle
Related skills
Installs
10
Repository
abuxton/skills
First Seen
Mar 7, 2026