Agent skill

github-ecosystem

Generate comprehensive GitHub ecosystem configuration including CI/CD workflows, issue templates, PR templates, CODEOWNERS, dependabot, and Copilot instructions. Language-agnostic with Python, Go, and TypeScript support. Auto-detects project language from pyproject.toml, go.mod, or package.json. Use when setting up GitHub repos, adding CI/CD pipelines, creating issue/PR templates, configuring dependabot, adding CODEOWNERS, setting up Copilot instructions, or enhancing existing projects with GitHub tooling. Works on new or existing repositories with smart merging.

View SKILL.md on GitHub Repository
Stars 20
Forks 3

Install this agent skill to your Project

npx add-skill https://github.com/zircote/.claude/tree/main/skills/github-ecosystem

SKILL.md

GitHub Ecosystem Configuration Generator

Generates production-ready GitHub configuration for any project.

Quick Start

Run in a project directory to auto-detect language and generate configuration:

bash
python scripts/generate_github_config.py --project-path .

Supported Languages

Language Detection Files CI Tools
Python pyproject.toml, setup.py ruff, mypy, bandit, pytest
Go go.mod golangci-lint, go test
TypeScript package.json + tsconfig.json eslint, prettier, tsc, vitest/jest

Components

GitHub Actions Workflows

ci.yml - Continuous Integration

  • Multi-version test matrix
  • Code quality checks (lint, format, typecheck)
  • Security scanning
  • Coverage reporting
  • Build verification

release.yml (optional) - Release Automation

  • Version bumping
  • GitHub Release creation
  • Package publishing
  • Changelog generation

docker.yml (optional) - Container Builds

  • Multi-platform builds (amd64, arm64)
  • GHCR publishing
  • Caching optimization

Issue Templates

  • bug_report.md - Structured bug reporting
  • feature_request.md - Feature proposals with API examples
  • config.yml - Template chooser configuration

Other Templates

  • PULL_REQUEST_TEMPLATE.md - PR checklist with change types
  • CODEOWNERS - Code ownership definitions
  • dependabot.yml - Automated dependency updates
  • copilot-instructions.md - GitHub Copilot context

Configuration Options

Option Default Description
--project-path . Project directory
--language (auto) Force language: python, go, typescript
--components all Comma-separated: workflows,templates,dependabot,codeowners,copilot
--include-release false Include release workflow
--include-docker false Include docker workflow
--codeowners (optional) CODEOWNERS entries (e.g., "* @team")
--overwrite false Overwrite existing files

Enhancement Mode

When .github/ already exists, the skill enters enhancement mode:

  • Detects existing configuration
  • Shows what will be added/modified
  • Merges without overwriting (unless --overwrite)
  • Preserves custom modifications

Generated Structure

.github/
├── workflows/
│   ├── ci.yml              # Always generated
│   ├── release.yml         # With --include-release
│   └── docker.yml          # With --include-docker
├── ISSUE_TEMPLATE/
│   ├── bug_report.md
│   ├── feature_request.md
│   └── config.yml
├── PULL_REQUEST_TEMPLATE.md
├── CODEOWNERS              # With --codeowners
├── dependabot.yml
└── copilot-instructions.md

Language-Specific Details

See reference files for detailed workflow patterns:

  • references/python-workflow.md - Python CI/CD patterns
  • references/go-workflow.md - Go CI/CD patterns
  • references/typescript-workflow.md - TypeScript CI/CD patterns

Post-Generation

After generation:

  1. Review generated workflows for your needs
  2. Add any required secrets (e.g., PYPI_API_TOKEN for publishing)
  3. Customize version matrices if needed
  4. Update CODEOWNERS with actual team handles

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

zircote/.claude

claude-code

20 3
Explore
zircote/.claude

file-organizer

Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.

20 3
Explore
zircote/.claude

engineer-skill-creator

Transform extracted engineer expertise into an actionable skill with progressive disclosure, allowing agents to find and apply relevant patterns for specific tasks.

20 3
Explore
zircote/.claude

Systematic Debugging

Four-phase debugging framework that ensures root cause investigation before attempting fixes. Never jump to solutions.

20 3
Explore
zircote/.claude

Defense-in-Depth Validation

Validate at every layer data passes through to make bugs impossible

20 3
Explore
zircote/.claude

Verification Before Completion

Run verification commands and confirm output before claiming success

20 3
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results