Dev Agent Skills

Agent skills for development workflows - Git, GitHub, and skill authoring. Production-ready skills that follow Conventional Commits and automate the full pull request lifecycle.

Overview

Dev Agent Skills provides a comprehensive set of Claude Code skills designed to automate Git and GitHub workflows. From creating compliant commits to managing full PR lifecycles, these skills enforce best practices and reduce manual effort.

Included Skills

Plugin 1: github-workflow

git-commit

Creates commits following Conventional Commits format with type/scope/subject.

Trigger Phrases:

• "Create a commit"
• "Commit changes"
• "Save work"
• "Stage and commit"

Features:

• ✅ Enforces Conventional Commits format: type(scope): subject
• ✅ 10 commit types: feat, fix, refactor, perf, test, ci, docs, chore, style, security
• ✅ Mandatory scope in kebab-case (e.g., auth, validation, cookie-service)
• ✅ Project convention checking from .claude/CLAUDE.md
• ✅ Subject line rules: max 50 chars, present tense imperative, no period
• ✅ Breaking Changes support with ! or BREAKING CHANGE:
• ✅ Git Trailers support: Fixes #N, Closes #N, Co-authored-by

Workflow:

1. Check project conventions (.claude/CLAUDE.md)
2. Review changes (git diff)
3. Stage files (git add)
4. Create commit (Conventional Commits compliant)
5. Verify commit (git log -1)

github-pr-creation

Creates PRs with automated validation, task tracking, and label suggestions.

Trigger Phrases:

• "Create a PR"
• "Open pull request"
• "Submit for review"
• "Check if ready for PR"

Features:

• ✅ Environment validation (GitHub CLI check)
• ✅ Task document analysis (from .kiro/specs/*/tasks.md)
• ✅ Commit analysis (type, scope, task refs, Breaking Changes)
• ✅ Task completion verification
• ✅ Automated test execution (make test, pytest, npm test)
• ✅ PR type recognition: feature, bugfix, hotfix, release, refactor
• ✅ Label suggestions based on commit type
• ✅ Template generation (7 PR templates: feature, release, bugfix, hotfix, refactor, docs, ci)

PR Type Mapping:

github-pr-merge

Merges PRs after validating pre-merge checklist.

Trigger Phrases:

• "Merge PR"
• "Close PR"
• "Finalize PR"
• "Complete merge"
• "Approve and merge"

Pre-Merge Checklist:

• ✅ Tests pass (make test)
• ✅ Linting passes (make lint or make check)
• ✅ CI checks green (gh pr checks $PR)
• ✅ All review comments replied
• ✅ No unresolved threads

Features:

• Comment status tracking
• User confirmation before merge
• Always uses --merge strategy (never squash or rebase)
• Automatic branch deletion (--delete-branch)
• Concise merge message format

Merge Message Example:

- Key change 1
- Key change 2
- Key change 3

Reviews: 7/7 addressed (Gemini 5, Codex 2)
Tests: 628 passed (88% cov)
Refs: Task 8, Req 14-15

github-pr-review

Handles PR review comments with severity classification.

Trigger Phrases:

• "Resolve PR comments"
• "Handle review feedback"
• "Fix review comments"
• "Address PR review"
• "Check review status"

Severity Classification:

Features:

• Priority processing: CRITICAL → HIGH → MEDIUM → LOW
• User confirmation before file edits
• Full issue verification after fixes
• Batch commit strategy:
  • Functional fixes (CRITICAL/HIGH) → individual commits
  • Cosmetic fixes (MEDIUM/LOW) → single batch style: commit
• Standard reply templates for all scenarios

Standard Reply Templates:

Plugin 2: skill-authoring

creating-skills

Guide for creating Claude Code skills following Anthropic's best practices.

Trigger Phrases:

• "Create a new skill"
• "Build a skill"
• "Write SKILL.md"
• "Help me create a skill"

Features:

• ✅ SKILL.md structure guidance
• ✅ Naming conventions (gerunds, noun phrases, prefix groups)
• ✅ Description formula: <What it does>. Use when <trigger phrases>. <Key capabilities>.
• ✅ Token budget management (SKILL.md < 500 lines)
• ✅ Helper scripts guidance
• ✅ Core principles and best practices

SKILL.md Structure:

1. Frontmatter metadata (name + description) - Required
2. Title (# Skill Name)
3. One-line description
4. Quick Start (minimal copy-paste example, < 30 lines)
5. Core Workflow (numbered steps)
6. Helper Scripts (table, if applicable)
7. Important Rules (key constraints with bold ALWAYS/NEVER)

Installation

Quick Install

# Add marketplace
/plugin marketplace add fvadicamo/dev-agent-skills

# Install plugins
/plugin install github-workflow@dev-agent-skills
/plugin install skill-authoring@dev-agent-skills

From Source

git clone git@github.com:fvadicamo/dev-agent-skills.git
cd dev-agent-skills
# Copy skills to your project

Key Design Principles

Model-Invoked Activation

Claude automatically activates skills based on your request:

• "Create a commit" → activates git-commit
• "Open a PR" → activates github-pr-creation
• "Merge the PR" → activates github-pr-merge
• "Address review comments" → activates github-pr-review
• "Help me create a skill" → activates creating-skills

Conventional Commits Standardization

All Git operations follow consistent Conventional Commits format, ensuring:

• Automated changelog generation
• Semantic versioning compatibility
• Better commit history readability
• Integration with CI/CD systems

Progressive Documentation

• SKILL.md (always loaded) - Core workflow
• references/ (loaded when needed) - Detailed guides
• External links (rarely needed) - Full documentation

User Confirmation Priority

All destructive operations require explicit user approval before proceeding.

Quality Over Quantity

Token budgets are strictly controlled (SKILL.md < 500 lines). Recent optimizations:

• github-pr-creation: 597 → 145 lines (-76%)
• github-pr-review: 511 → 161 lines (-69%)

Workflow Integration

Complete Development Lifecycle

git-commit → github-pr-creation → github-pr-review → github-pr-merge
     ↓            ↓                  ↓                  ↓
  规范提交      创建PR             解决评论            合并PR

This creates a seamless development workflow that enforces best practices at every step.

Use Cases

Team Standardization

• Enforce consistent commit messages across team members
• Automate PR creation and review workflows
• Standardize merge strategies and procedures
• Reduce manual review effort

Open Source Maintenance

• Streamline contribution handling
• Automate PR validation and merging
• Track review comments systematically
• Generate consistent changelogs

Skill Development

• Create high-quality Claude Code skills
• Follow Anthropic's best practices
• Optimize token usage
• Maintain documentation standards

Technical Details

Token Optimization

Total: ~1,427 lines (optimized from ~4,000 lines)

Dependencies

• GitHub CLI (gh)
• Git
• Claude Code CLI

Plugin Structure

{
  "plugins": [
    {
      "name": "github-workflow",
      "description": "Git commit, PR creation, review, and merge skills",
      "skills": [
        "./skills/git-commit",
        "./skills/github-pr-creation",
        "./skills/github-pr-merge",
        "./skills/github-pr-review"
      ]
    },
    {
      "name": "skill-authoring",
      "description": "Guide for creating Claude Code skills",
      "skills": ["./skills/creating-skills"]
    }
  ]
}

Best Practices

Commit Workflow

1. Always stage intentionally: Review changes before staging
2. Use meaningful scopes: Be specific about what changed
3. Write clear subjects: Present tense, imperative, under 50 chars
4. Reference issues: Use Fixes #N for automatic issue closing

PR Workflow

1. Validate before creation: Ensure tasks are complete
2. Run automated tests: Let the skill execute tests for you
3. Choose appropriate type: Feature, bugfix, hotfix, etc.
4. Address reviews methodically: Process comments by severity

Merge Workflow

1. Verify all checks: Test, lint, CI must pass
2. Review all comments: Ensure every comment is addressed
3. Get explicit approval: Never merge without user confirmation
4. Clean up afterwards: Delete merged branches

Limitations

• Requires GitHub CLI installed and authenticated
• Git repository must be initialized
• Some features assume Conventional Commits convention
• Designed primarily for GitHub (not GitLab, Bitbucket, etc.)

Reference Documentation

Each skill includes detailed reference documentation:

• git-commit/references/commit_examples.md - 293 lines of examples
• github-pr-creation/references/conventional_commits.md - 99 lines
• github-pr-creation/references/pr_templates.md - 461 lines
• github-pr-review/references/gemini_severity_guide.md - 163 lines
• creating-skills/references/official_best_practices.md - 277 lines
• creating-skills/references/skill_examples.md - 243 lines

Related Skills

• Vercel Agent Skills - AI-powered agent workflows
• Skill Authoring Best Practices - Anthropic's official guidelines
• GitOps Automation - Infrastructure as Git workflows

Example Usage

Creating a Commit

User: Create a commit for the auth changes

Skill: Analyzes changes, stages files, creates:
feat(auth): add JWT token validation

- Implement JWT verification middleware
- Add refresh token rotation
- Update auth tests

Fixes #42

Creating a PR

User: Create a PR for the feature

Skill: Validates tasks, runs tests, generates PR:
Title: feat(user-profile): add avatar upload support
Type: Feature
Labels: enhancement, user-profile
Branch: feature/avatar-upload → develop

Merging a PR

User: Merge PR #123

Skill: Checks all validations, prompts for confirmation:
✓ Tests: 628 passed (88% cov)
✓ Lint: No errors
✓ CI: All checks green
✓ Reviews: 7/7 addressed

Merge? (y/n): y

Statistics