Agent Skills by @rlespinasse

A collection of Agent Skills for AI coding assistants.

Available Skills

conventional-commit

Guides committing staged (indexed) git files using the Conventional Commits specification and commit message best practices. Use when user mentions commit, git commit, conventional commit, commit message, staged files, indexed files, fixup, or fixup commit. Helps craft well-structured, meaningful commit messages including fixup commits with optional autosquash.

npx skills add https://github.com/rlespinasse/agent-skills --skill conventional-commit

diataxis

Helps maintain documentation pages based on the Diataxis method. Analyzes existing docs, classifies pages into tutorials/how-to/explanation/reference categories, identifies gaps, and helps create or restructure documentation following Diataxis principles. Use when user mentions documentation structure, Diataxis, doc categories, tutorials vs how-to guides, or reorganizing docs.

npx skills add https://github.com/rlespinasse/agent-skills --skill diataxis

drawio-export-tools

Decision guide for the third-party Draw.io export ecosystem by @rlespinasse. Covers docker-drawio-desktop-headless (base Docker), drawio-exporter (Rust backend), drawio-export (enhanced Docker), and drawio-export-action (GitHub Actions). Use when user mentions diagram export, CI/CD automation, batch processing, or Draw.io files. Helps select the right tool based on context.

npx skills add https://github.com/rlespinasse/agent-skills --skill drawio-export-tools

french-language

Ensures all project content is written in proper French with correct accents, grammar, and typography. Use when user mentions french, français, langue française, accents, orthographe, typographie, or when working on a project that requires French language content. Also use when generating any text-based file (SVG, Mermaid, PlantUML, Draw.io, HTML, CSV, JSON, YAML, etc.) in a French-language project. Helps enforce French writing conventions across all file types.

npx skills add https://github.com/rlespinasse/agent-skills --skill french-language

local-branches-status

Reports the status of all local git branches with remote sync state, main branch diff, worktree path, last activity date, and content description. Use when user mentions branch status, branch overview, local branches, branch report, or branch summary. Helps understand the state of all branches at a glance.

npx skills add https://github.com/rlespinasse/agent-skills --skill local-branches-status

pin-github-actions

Migrates GitHub Actions workflows to use pinned commit SHAs instead of tags, resolves the latest release versions, flags major version jumps, and configures Dependabot with grouped updates. Use when user mentions pin actions, pinned versions, SHA pinning, GitHub Actions security, dependabot setup, or supply-chain security.

npx skills add https://github.com/rlespinasse/agent-skills --skill pin-github-actions

verify-pr-logs

Checks GitHub Actions CI logs on a pull request, diagnoses failures, and guides the agent to implement fixes. Use when user mentions CI failing, check PR logs, fix pipeline, GitHub Actions errors, workflow failures, build broken, tests failing on PR, or debug CI. Focuses on PR-scoped CI analysis only.

npx skills add https://github.com/rlespinasse/agent-skills --skill verify-pr-logs

verify-readme-features

Verifies that features listed in a README (or similar documentation) are actually implemented in the codebase. Use when user mentions verify features, check feature list, confirm README, validate documentation claims, or audit feature accuracy. Helps catch stale, missing, or inaccurate feature descriptions.

npx skills add https://github.com/rlespinasse/agent-skills --skill verify-readme-features

Installation

Via npx (recommended)

Install all skills:

npx skills add https://github.com/rlespinasse/agent-skills

Install specific skill:

npx skills add https://github.com/rlespinasse/agent-skills --skill drawio-export-tools

Via Claude Code plugin

This repository includes a .claude-plugin/marketplace.json manifest for Claude Code plugin installation:

/plugin marketplace add rlespinasse/agent-skills
/plugin install drawio-export-tools

Supported Agents

These skills work with:

Related Projects

About

Author: @rlespinasse

These skills follow the Agent Skills specification and are designed to help AI agents make better decisions across common development tasks.

Contributing

Contributions are welcome! See the Contributing Guidelines for full details, and the Skill Specification Reference for frontmatter and evals requirements.

Quick Start for Contributors

# Create a new skill
just new-skill my-skill-name

# Validate and test
just check

# Commit with conventional format
git commit -m "feat(skill): add my-skill-name"

License

MIT License - see LICENSE file for details.