A GitHub Action that generates an SVG badge showing OpenSpec metrics for your repository. The badge displays key project health indicators at a glance:

• Total specs — number of specification files
• Total requirements — number of defined requirements
• Open changes — changes currently in progress
• Task status — open vs. closed tasks

Add the action to a GitHub Actions workflow:

name: OpenSpec Badge
on:
  push:
    branches: [main]

jobs:
  badge:
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - uses: actions/checkout@v4
      - uses: weAretechnative/openspec-badge-action@main
        with:
          metric_types: number_of_specs,number_of_requirements,tasks_status,open_changes
          badge_style: flat

Note: The action needs contents: write permission to push badges to the gh-pages branch.

After the action runs, badges are deployed to the gh-pages branch. Reference them in your README using:

![specs](https://raw.githubusercontent.com/<owner>/<repo>/gh-pages/badges/number_of_specs.svg)
![requirements](https://raw.githubusercontent.com/<owner>/<repo>/gh-pages/badges/number_of_requirements.svg)
![tasks](https://raw.githubusercontent.com/<owner>/<repo>/gh-pages/badges/tasks_status.svg)
![changes](https://raw.githubusercontent.com/<owner>/<repo>/gh-pages/badges/open_changes.svg)

Replace <owner>/<repo> with your GitHub repository path.

The action supports different visual styles and label options. Here are all available badge variants:

Metric Type	Classic (unlabeled)	Classic (labeled)	Flat (unlabeled)	Flat (labeled)
Specs
Requirements
Tasks
Changes

Apache 2.0 — see LICENSE for details.

Contributions are welcome! This project uses OpenSpec for structured change management. Check the open issues for tasks to pick up.