⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

version unknown

decision-records

@fvadicamo⭐ 72 stars

Creates, supersedes and validates decision records (ADRs) against the convention a collection already follows, instead of imposing a published one. Use when the user wants to record a decision, write an ADR, supersede an existing decision, audit or lint a decisions folder, check that an ADR index is in sync, or asks "why did we decide X". Deduces the filename scheme, section set and status vocabulary from the records already there; ships a validator with an exit code, so the audit is a check and not an opinion.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐ 72 on GitHubGitHub ↗

Growing

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

dev-agent-skills

Agent skills and hooks for development workflows - Git, GitHub, skill authoring, safety guardrails, public-repo privacy, and decision records.

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
/plugin install guardrails@dev-agent-skills
/plugin install privacy-guard@dev-agent-skills
/plugin install decision-records@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
  • "Set up the privacy guard on this public repo" -> activates privacy-guard
  • "Record this decision" / "check our ADRs" -> activates decision-records

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 skillWith this skill
Inconsistent commit format across a sessionEnforces CC format with required scope, max 50 chars, imperative tense
Ignores existing commit style in the projectDynamic 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 commitsProvides 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 skillWith this skill
Often skips target branch confirmationAlways asks user to confirm base branch
Doesn't search for task documentationSearches Kiro, Cursor, Trae, GitHub Issues, and generic paths for task specs
No task completion validationMaps commits to tasks and reports missing sub-tasks before creating PR
Suggests labels that may not exist in the projectChecks gh label list first, matches available labels, suggests creating missing ones
Generic PR body7 type-specific templates (feature, release, bugfix, hotfix, refactoring, docs, CI/CD)
May skip testsTests 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 skillWith this skill
May merge without checking review commentsDetects unreplied comments via jq query, stops merge and redirects to review skill
Inconsistent merge strategyAlways merge commit (--merge), never squash/rebase
Verbose or empty merge messagesConcise format: 3-5 bullets + reviews/tests/refs (~10 lines max)
May skip CI/lint checksFull pre-merge checklist (tests, lint, CI, comments) with summary shown to user
Forgets branch cleanupAuto-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:

Without this skillWith this skill
Processes comments in random orderClassifies by severity (CRITICAL > HIGH > MEDIUM > LOW) and processes in order
No severity detectionDetects Gemini badges, Cursor HTML comments, and keyword-based severity
One commit per fix regardless of impactBatch strategy: separate commits for functional fixes, single batch for cosmetic
May use -f in_reply_to=... (broken)Uses correct --input - JSON syntax for thread replies
Generic or no replies to threadsStandard templates: Fixed, Won't fix, By design, Deferred, Acknowledged
Triggers bot review loops on every pushStrategies to avoid loops: batch pushes, draft PR, skip keywords
Forgets to submit formal reviewPrompts gh pr review with appropriate flag (approve/request-changes/comment)

Plugin: skill-authoring

creating-skills

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

What it adds over Claude's default behavior:

Claude knows the basics of skill creation, but this skill provides a comprehensive, up-to-date reference covering features that Claude may not know about or consistently apply.

  • Complete frontmatter reference (all 10 fields including allowed-tools, context, agent, hooks)
  • Invocation control matrix (disable-model-invocation, user-invocable)
  • Dynamic features: context injection (!`cmd`), string substitutions ($ARGUMENTS), subagent execution
  • Degrees of freedom concept for matching specificity to task fragility
  • Directory structure with scripts/, references/, and assets/ resource types
  • Description formula, naming conventions, progressive disclosure patterns

Comparison with the official skill-creator

This skill complements the official skill-creator from Anthropic. They serve different purposes and can be used together.

FeatureThis skillOfficial skill-creator
Complete frontmatter reference (10 fields)YesNo (only 5 fields)
Invocation control matrixYesNo
Dynamic context injection (!`cmd`)Yes, with examplesNo
String substitutions ($ARGUMENTS, $1)YesNo
Subagent execution (context: fork)Yes, with exampleNo
Discovery hierarchyYesNo
Context budget (2%, 16k fallback)YesNo
Skills/commands unificationYesNo
Frontmatter validation rulesYesNo
6 feature-specific examplesYesNo
Scaffolding script (init_skill.py)NoYes
Packaging script (package_skill.py)NoYes
Validation script (quick_validate.py)NoYes
Workflow patterns referenceNoYes
Output patterns referenceNoYes

In short: this skill is a practical, up-to-date reference for all available features. The official skill is a conceptual guide with scaffolding/packaging tools. Install both for the most complete experience.

Plugin: guardrails

Safety guardrails for running Claude Code with reduced supervision (for example under --dangerously-skip-permissions). It currently ships one PreToolUse hook; mo

// HOW IT'S BUILT

KEY FILES

plugins/decision-records/skills/decision-records/SKILL.mdREADME.md

// REPO STATS

72 stars