skill-authoring

dev-agent-skills

Agent skills for development workflows - Git, GitHub, and skill authoring.

These skills are designed for Claude Code, the CLI tool by Anthropic.

Why these skills?

Claude Code already knows how to commit, create PRs, and review code. But without structured guidance it tends to:

• Use inconsistent commit formats across a session
• Skip target branch confirmation and create PRs against the wrong branch
• Not search for task documentation or validate task completion before opening a PR
• Suggest labels that don't exist in the project
• Process review comments in random order instead of by severity
• Use the wrong GitHub API syntax for replying to threads (-f instead of --input -)
• Generate verbose merge messages that clutter the git log
• Merge without verifying all review comments have been addressed

These skills add structured workflows that prevent these issues. They don't replace Claude's capabilities - they guide them through the right sequence of steps.

There are no official Anthropic skills for Git/GitHub workflows. This plugin fills that gap.

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

How skills work

Skills are model-invoked - Claude automatically activates them 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

Plugin: github-workflow

Skills for Git and GitHub workflows following Conventional Commits.

git-commit

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

What it adds over Claude's default behavior:

Without this skill	With this skill
Inconsistent commit format across a session	Enforces CC format with required scope, max 50 chars, imperative tense
Ignores existing commit style in the project	Dynamic context injection loads recent commits so Claude matches the style
Sometimes uses generic messages ("update code")	Strict rules against vague messages
No HEREDOC for multi-line commits	Provides HEREDOC pattern for clean multi-line messages

Additional features:

• Checks CLAUDE.md for project-specific commit conventions
• Extra commit type security beyond standard CC

github-pr-creation

Creates Pull Requests with automated validation, task tracking, and label suggestions.

What it adds over Claude's default behavior:

Without this skill	With this skill
Often skips target branch confirmation	Always asks user to confirm base branch
Doesn't search for task documentation	Searches Kiro, Cursor, Trae, GitHub Issues, and generic paths for task specs
No task completion validation	Maps commits to tasks and reports missing sub-tasks before creating PR
Suggests labels that may not exist in the project	Checks gh label list first, matches available labels, suggests creating missing ones
Generic PR body	7 type-specific templates (feature, release, bugfix, hotfix, refactoring, docs, CI/CD)
May skip tests	Tests must pass before PR creation

github-pr-merge

Merges Pull Requests after validating a pre-merge checklist.

What it adds over Claude's default behavior:

Without this skill	With this skill
May merge without checking review comments	Detects unreplied comments via jq query, stops merge and redirects to review skill
Inconsistent merge strategy	Always merge commit (--merge), never squash/rebase
Verbose or empty merge messages	Concise format: 3-5 bullets + reviews/tests/refs (~10 lines max)
May skip CI/lint checks	Full pre-merge checklist (tests, lint, CI, comments) with summary shown to user
Forgets branch cleanup	Auto-deletes remote branch, switches to develop and pulls

github-pr-review

Handles PR review comments and feedback resolution.

What it adds over Claude's default behavior: