shieldsio

Installation
SKILL.md

Shields.io

Use this skill when you need to:

  • build or edit Shields.io badge URLs
  • choose common badge parameters such as style, label, colors, logos, cache lifetime, and click targets
  • work with dynamic JSON, TOML, XML, or YAML badges
  • check integration-specific notes for GitHub, Gitea, Sonar, Open Collective, or self-hosted Shields
  • look up upgrade, security, or compatibility changes such as Simple Icons updates and the Dynamic JSON/TOML/YAML advisory

Start Here

  • references/getting-started.md for the product surface and where to begin
  • references/core-patterns.md for recurring badge parameters and common URL patterns
  • references/api-reference.md for dynamic badge inputs and static badge docs

Reference Files

  • references/getting-started.md for intro, builder workflow, and product entry points
  • references/core-patterns.md for shared badge parameters, logos, filters, and common caveats
  • references/api-reference.md for Dynamic JSON, TOML, XML, and YAML badge inputs plus static badge docs
  • references/testing-debugging.md for troubleshooting selectors, compatibility issues, and service caveats
  • references/integrations-plugins.md for GitHub OAuth, self-hosted services, Badge-Maker, Docker, and related integrations
  • references/upgrades.md for security advisories, migration notes, and Simple Icons changes
  • references/badges.md for the full extracted badge catalog

Retrieval Tips

  • Start with the compact references above before opening references/badges.md.
  • Use references/badges.md when you need service-specific path parameters or examples for a particular badge.
Related skills

More from aaronflorey/agent-skills

Installs
3
First Seen
Apr 16, 2026