Skip to content

Latest commit

 

History

History
265 lines (204 loc) · 19.2 KB

File metadata and controls

265 lines (204 loc) · 19.2 KB

🤖 DX Toolkit

The Swiss army knife for developer experience — AI-powered agents, workflows, prompts, instructions, skills, hooks, and templates you copy into any repository.

GitHub Actions GitHub Copilot License: MIT


What's Inside

Component Count What it does
Agents 45+ Specialized Copilot coding agents — assign to issues, get PRs
Prompts 27+ One-shot task templates via the / slash menu
Instructions 25+ Auto-attached rules per file type + context modes
Skills 34+ Multi-step structured workflows organized by domain
Workflows 25 AI-powered GitHub Actions (review, triage, security, docs)
Hooks 10 Quality gates — format, guard, scan, lint, track, protect
References 10 Checklists for testing, security, performance, mobile, APIs
Templates 3 Structured issue forms + PR template
Tooling Prettier, VS Code config, 7 MCP servers, DevContainer
Examples 4 Real-world copilot-instructions.md for popular stacks

Quick Start

# Clone
git clone https://github.com/dreamingechoes/dx-toolkit.git

# Copy to your project (all components)
TARGET=~/Code/my-project
cp -r templates/agents/ "$TARGET/.github/agents/"
cp -r templates/skills/ "$TARGET/.github/skills/"
cp -r templates/prompts/ "$TARGET/.github/prompts/"
cp -r templates/instructions/ "$TARGET/.github/instructions/"
cp -r templates/hooks/ "$TARGET/.github/hooks/"
cp -r templates/ISSUE_TEMPLATE/ "$TARGET/.github/ISSUE_TEMPLATE/"
cp templates/PULL_REQUEST_TEMPLATE.md "$TARGET/.github/"
cp templates/copilot-instructions.md "$TARGET/.github/"
cp templates/workflows/*.yml "$TARGET/.github/workflows/"
chmod +x "$TARGET/.github/hooks/scripts/"*.sh

Local bootstrap (interactive — no GitHub API needed):

./scripts/bootstrap.sh ~/Code/my-project

Development Lifecycle

Skills and prompts follow a six-phase development lifecycle:

  EXPLORE  ──→  OUTLINE  ──→  DEVELOP  ──→  CHECK  ──→  POLISH  ──→  LAUNCH
  /explore      /outline      /develop      /check      /polish      /launch
Phase Command What Happens
EXPLORE /explore Explore a vague idea, refine it into a spec with requirements and scope
OUTLINE /outline Outline the spec into small, ordered, verifiable tasks
DEVELOP /develop Develop the next task in a thin vertical slice with tests
CHECK /check Reproduce, localize, fix, and guard against regressions
POLISH /polish Review code for correctness, simplicity, security, and performance
LAUNCH /launch Clean commits, update docs, run pre-launch checklist, deploy

Each command activates the relevant skills automatically. Use them individually or chain them: /explore/outline/develop/check/polish/launch.


How It Works

┌─────────────────────────────────────────────────────────────────────────┐
│                    YOUR EDITOR                                          │
│                                                                         │
│  Agents ──── Assign to issues → get PRs automatically                   │
│  Prompts ─── /explore, /outline, /develop, /check, /polish, /launch     │
│  Skills ──── 34+ structured workflows by lifecycle phase                │
│  Instructions ── Auto-rules + context modes for .ts, .ex, .py, .go, .rs │
│  Hooks ───── Quality gates — format, guard, scan, protect               │
│                                                                         │
├─────────────────────────────────────────────────────────────────────────┤
│                     DEVELOPER TOOLING                                   │
│                                                                         │
│  VS Code ──── Settings, extensions, format-on-save                      │
│  MCP ──────── GitHub, Fetch, Filesystem, Memory, Thinking, Context7     │
│  Prettier ─── Format MD, YML, JSON — npm run format                     │
│  DevContainer  Ready-to-use Codespaces / container env                  │
│                                                                         │
├─────────────────────────────────────────────────────────────────────────┤
│                  YOUR REPOSITORY (GitHub)                               │
│                                                                         │
│  Workflows ── PR review, labeling, security scanning                    │
│  Templates ── Structured issue forms, PR checklist                      │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

Agents handle autonomous issue-to-PR workflows. Prompts are quick single-task actions. Instructions silently shape every suggestion Copilot makes. Skills guide multi-step procedures. Hooks run scripts on tool calls. Workflows automate CI/CD and triage. Templates standardize issues and PRs.


Agents (45+)

9 General-Purpose: bug-fixer, feature-implementer, refactorer, test-writer, docs-updater, docs-humanizer, security-fixer, performance-optimizer, dependency-updater

31+ Technology-Specialized: elixir-expert, phoenix-expert, typescript-expert, nextjs-expert, postgresql-expert, supabase-expert, docker-expert, wordpress-expert, design-systems-expert, frontend-expert, backend-expert, conventional-commits-expert, web-development-expert, react-expert, react-native-expert, expo-expert, tdd-expert, bdd-expert, payments-expert, python-expert, go-expert, rust-expert, swift-expert, kotlin-expert, flutter-expert, rails-expert, vue-expert, angular-expert, svelte-expert, graphql-expert, terraform-expert

2 Content-Specialized: seo-writer, marketing-expert

Full agent guide with usage examples

Prompts (27+)

Lifecycle commands: /explore · /outline · /develop · /check · /polish · /launch

Task prompts: /scaffold-component · /write-tests · /explain-code · /refactor-function · /create-api-endpoint · /write-migration · /create-dockerfile · /review-security · /generate-types · /debug-error · /optimize-query · /commit-message · /refine-issue · /setup-monorepo · /write-adr · /create-workflow · /analyze-deps · /create-api-client · /document-api · /setup-ci · /create-test-fixtures · /review-accessibility · /setup-logging

Full prompt guide with examples

Instructions (25+)

Auto-attached: Elixir · TypeScript · React · CSS · Docker · Testing · Migrations · Writing Style · Python · Ruby · Go · Rust · Swift · Kotlin · Vue · GraphQL

Context modes: Development · Review · Research · Debugging

On-demand: API Design · Accessibility · Git Workflow

Full instructions guide

Skills (34+)

Category Skills
Product & Discovery idea-refine · spec-driven-development · codebase-onboarding
Planning & Design planning-and-task-breakdown · issue-to-plan · api-design · database-schema · architecture-review
Development incremental-implementation · context-engineering · debugging-and-error-recovery · token-optimization
Code Quality code-review · code-simplification · performance-optimization · security-audit · refactoring-catalog · accessibility-audit
Testing & Quality testing-strategy · dependency-audit
Documentation & Communication documentation-and-adrs · pr-description · humanize-writing
DevOps & Delivery git-workflow-and-versioning · ci-cd-and-automation · deployment-checklist · shipping-and-launch · feature-flag-management · infrastructure-as-code · error-monitoring-setup · logging-and-observability
Mobile mobile-release · mobile-testing
Architecture monorepo-setup · architecture-review
Project Management estimation-and-sizing · incident-response

Full skills guide · Skill anatomy

Workflows (25)

Category Workflows
Issue & PR Smart Labeler · Issue Quality Enhancer · Duplicate Detector · First Contributor Welcome · Stale Issue Manager · Auto Assign Reviewers · PR Size Checker · Conventional Commit Checker
Code Quality PR Code Reviewer · Continuous Docs · Code Coverage Report · License Compliance · Todo Tracker
Security Security Scanner · Container Image Scanner
Maintenance Release Notes Generator · Auto Changelog · Dependency Update Checker · Branch Cleanup · Broken Link Checker
Monorepo Monorepo Change Detector
Docs API Docs Generator · Wiki Docs Sync
Tooling Copilot Suggester · Label Beautifier

Full workflow guide


Documentation

Guide Description
Getting Started Prerequisites, quickstart, what happens automatically
Agents All 45+ agents with purpose, workflow, and usage examples
Prompts All 27+ prompts with inputs, outputs, and examples
Instructions All 25+ instructions — auto-attached, context modes, on-demand
Skills All 34+ skills organized by domain
Skill Anatomy How to write and structure skills
Workflows All 25 workflows with triggers, inputs, and setup
Hooks 10 hooks — formatting, guards, scanning, tracking, protection
Templates Issue forms and PR template customization
Installation Automated installer, manual copy, git subtree
Customization Create your own agents, prompts, instructions, skills, hooks
Architecture Component hierarchy, lifecycle model, data flow
Monorepo Guide Strategies for monorepo setups with scoped agents
Mobile Guide React Native, Expo, Flutter, Swift, Kotlin workflows
FAQ Common questions answered
Troubleshooting Symptom → cause → fix for common issues
Recipes Step-by-step guides for common setups
Changelog Version history and breaking changes
Editor & Tooling Prettier, VS Code, MCP servers, DevContainer, EditorConfig

Multi-Tool Setup

Guide Description
Copilot Setup GitHub Copilot in VS Code — native integration
Claude Setup Claude Code — uses CLAUDE.md as entry point
Cursor Setup Cursor — .cursorrules and @file references
Windsurf Setup Windsurf — .windsurfrules and Cascade

Project Structure

templates/
├── agents/                   45+ Copilot agents (.agent.md)
├── skills/                   34+ multi-step skills (SKILL.md)
├── prompts/                  27+ task prompts (.prompt.md)
├── instructions/             25+ coding rules (.instructions.md)
├── hooks/                    10 hook configs + scripts
├── references/               10 reference checklists
├── workflows/                25 standalone GitHub Actions
├── ISSUE_TEMPLATE/           Bug report + Feature request (YAML forms)
├── PULL_REQUEST_TEMPLATE.md
└── copilot-instructions.md
.github/
├── workflows/                CI for this repo (ci, pr-checks, link-checker, stale, welcome)
├── ISSUE_TEMPLATE/           Issue forms for this repo
├── PULL_REQUEST_TEMPLATE.md  PR template for this repo
├── copilot-instructions.md   Copilot config for this repo
└── labeler.yml               Path-based label rules
CLAUDE.md                     Entry point for Claude Code
AGENTS.md                     Agent directory for AI tools
scripts/                      Bootstrap installer script
docs/                         Comprehensive documentation + recipes
examples/                     Real-world copilot-instructions.md configs
.vscode/                      VS Code settings, extensions, MCP servers
.devcontainer/                Dev container (Codespaces-ready)

CI & Repository Protection

This repository runs its own CI on every PR and push to main:

Workflow Trigger What it checks
✅ CI PR + push to main Prettier, YAML/JSON/bash syntax, frontmatter, file conventions
🛡️ PR Checks PR open/edit Conventional Commits title, size label, path-based labels
🔗 Link Checker Push to main + weekly Broken internal and external links in markdown
🧹 Stale Daily Marks inactive issues/PRs stale, closes after 7 more days
👋 Welcome First issue/PR Greets first-time contributors

Recommended branch protection rules for main:

  • Require PR reviews before merging
  • Require status checks: Format Check, Validate YAML, Validate JSON, Validate Shell Scripts, Validate Frontmatter, Validate File Structure, Conventional Commits Title
  • Require branches to be up to date
  • Do not allow bypassing the above settings

Contributing

Contributions welcome! See CONTRIBUTING.md.

License

MIT — see LICENSE.