Code Skills

A collection of skills for AI coding agents. Skills are packaged instructions, scripts, and reference material that extend an agent's capabilities for common software engineering workflows.

Skills in this repository follow the Agent Skills format.

Available Skills

conventional-commit-message

Create, validate, rewrite, and explain Git commit messages using an opinionated Conventional Commits format. The skill can stage repository changes, inspect the staged diff, derive a commit message, validate the header, and create exactly one commit.

Use when:

• Committing current repository changes
• Validating an existing commit message
• Rewriting a commit message to match Conventional Commits
• Explaining why a commit message does or does not satisfy the local convention

Covers:

• Typed Conventional Commit headers
• Optional scopes and breaking-change markers
• Body and footer guidance
• Issue footer placement
• Merge, revert, and initial commit special cases
• Deterministic header validation with the skill-owned Python 3 helper

Included files:

• SKILL.md - agent instructions and workflow
• scripts/validate_commit_header.py - header validator
• references/convention.md - detailed examples and versioning notes

maintainability-code-review

Review unmerged branch changes against the repository default branch for KISS, DRY, and Boolean design issues. The skill focuses on overcomplicated code, unnecessary abstraction, duplicated changing knowledge, ambiguous Boolean names, and Boolean APIs that hide intent before a branch is merged.

Use when:

• Reviewing branch or pull request changes for KISS, DRY, and Boolean concerns
• Checking unmerged changes against the repository default branch
• Finding over-engineered code, avoidable indirection, or premature abstraction
• Finding duplicated business rules, mappings, constants, validations, or test setup
• Finding unclear Boolean names, negative polarity, multi-purpose state, or opaque Boolean parameters
• Producing a maintainability-focused code review with actionable fixes

Covers:

• Git-based default branch discovery or an explicit base branch
• KISS checks for unnecessary complexity, control flow, public surface area, configuration, and test setup
• DRY checks for duplicated change-prone knowledge across code, tests, schemas, build logic, and documentation
• Guardrails against recommending premature abstraction when local duplication is clearer
• Separate KISS and DRY passes for large or risky diffs
• Boolean naming checks for clear questions, grammatical prefixes, and positive polarity
• Boolean design checks for overloaded state and unclear positional arguments
• Validation and prioritization guidance to reduce speculative findings
• Severity-based review output with file and line references

Included files:

• SKILL.md - agent instructions and workflow

pull-request-message

Draft, improve, rewrite, and review pull request or merge request descriptions from repository changes, branch diffs, commit lists, provided patches, or existing drafts. The skill uses an opinionated template that separates summary, motivation, modifications, result, and validation.

Use when:

• Drafting a PR or MR description from local changes
• Improving an existing PR or MR message
• Turning a diff, branch, or commit list into reviewer-friendly context
• Reviewing whether a PR/MR template has the right sections

Covers:

• Diff and commit inspection guidance
• Motivation, implementation, result, and validation separation
• Optional screenshots, risks, rollout, and follow-up sections
• Copy-ready output guidance
• Template variants for documentation-only and small changes

Included files:

• SKILL.md - agent instructions and workflow
• references/template.md - template variants and examples

Installation

Install this skill collection with the Agent Skills CLI:

npx skills add ankitgoyalio/code-skills

Usage

Skills are automatically available once installed. The agent will load the full skill instructions only when a relevant task is detected.

conventional-commit-message examples

Commit my changes

Validate this commit message: feat(api): add user search

Rewrite this commit message using our convention

maintainability-code-review examples

Review my unmerged changes for KISS and DRY issues

Check this branch for over-engineering and duplicated logic before I open a PR

Review the Boolean names and parameters introduced by this branch

pull-request-message examples

Draft a pull request message from my current changes

Improve this merge request description

Skill Structure

Each skill directory contains:

• SKILL.md - required instructions and metadata for the agent
• scripts/ - optional helper scripts for deterministic checks or automation
• references/ - optional supporting documentation loaded only when needed

Keep SKILL.md focused and move detailed examples, long rule lists, and background material into references/ so agents can use context efficiently.

Skill Design Standard

Add a skill only when it preserves context learned from solving a real problem or removes repetition from an established workflow. Do not create a skill as a substitute for first solving and understanding an unfamiliar task.

• Put precise activation cues and the skill's distinctive value in front matter.
• Keep operational instructions in SKILL.md; avoid repeating activation text after the skill has loaded.
• Add deterministic scripts for fragile or repeatedly reconstructed command sequences.
• Put edge cases and detailed examples in references that are loaded only when needed.
• Revise a skill after actual use exposes a missing prerequisite, failure mode, or recurring intervention.

Contributing

When adding or changing a skill, update this README in the same change so the skill catalog, installation notes, and usage examples stay accurate.

License

MIT