mpuig-skills

Python-focused agent skills, following the Agent Skills open format.

Inspired by getsentry/skills and adapted for Python development.

Installation

Claude Code (via Marketplace)

# Add the marketplace
claude plugin marketplace add mpuig/skills

# Install the plugin
claude plugin install mpuig-skills@mpuig-skills

Claude Code (from local clone)

# Clone the repository
git clone git@github.com:mpuig/skills.git ~/mpuig-skills

# Install the marketplace from the local clone
claude plugin marketplace add ~/mpuig-skills

# Install the plugin directly
claude plugin install mpuig-skills

After installation, restart Claude Code. The skills will be automatically invoked when relevant to your task.

Updating

# Update the marketplace index
claude plugin marketplace update

# Update the plugin
claude plugin update mpuig-skills@mpuig-skills

Or use /plugin to open the interactive plugin manager.

Other Agents

Copy the skills/ directory to your agent's skills location, or reference the SKILL.md files directly according to your agent's documentation.

Available Skills

Skill	Description
code-review	Python code review guidelines and checklist
commit	Conventional commit message conventions
create-pr	Create pull requests following best practices
find-bugs	Find bugs and security vulnerabilities in branch changes
iterate-pr	Iterate on a PR until CI passes and feedback is addressed
claude-settings-audit	Analyze repo and generate recommended Claude Code settings.json permissions
agents-md	Maintain AGENTS.md with concise agent instructions

Available Subagents

Subagent	Description
code-simplifier	Simplifies and refines Python code for clarity, consistency, and maintainability while preserving all functionality

Repository Structure

mpuig-skills/
├── .claude-plugin/
│   └── marketplace.json      # Marketplace manifest
├── plugins/
│   └── mpuig-skills/
│       ├── .claude-plugin/
│       │   └── plugin.json   # Plugin manifest
│       ├── agents/
│       │   └── code-simplifier.md
│       └── skills/
│           ├── code-review/
│           │   └── SKILL.md
│           └── commit/
│               └── SKILL.md
├── AGENTS.md                 # Agent-facing documentation
├── CLAUDE.md                 # Symlink to AGENTS.md
└── README.md                 # This file

Creating New Skills

Skills follow the Agent Skills specification. Each skill requires a SKILL.md file with YAML frontmatter.

Skill Template

Create a new directory under plugins/mpuig-skills/skills/:

plugins/mpuig-skills/skills/my-skill/
└── SKILL.md

SKILL.md format:

---
name: my-skill
description: A clear description of what this skill does and when to use it. Include keywords that help agents identify when this skill is relevant.
---

# My Skill Name

## Instructions

Step-by-step guidance for the agent.

## Examples

Concrete examples showing expected input/output.

## Guidelines

- Specific rules to follow
- Edge cases to handle

Naming Conventions

name: 1-64 characters, lowercase alphanumeric with hyphens only
description: Up to 1024 characters, include trigger keywords
Keep SKILL.md under 500 lines; split longer content into reference files

Optional Fields

Field	Description
`license`	License name or path to license file
`compatibility`	Environment requirements (max 500 chars)
`model`	Override model for this skill (e.g., `sonnet`, `opus`, `haiku`)
`allowed-tools`	Space-delimited list of tools the skill can use
`metadata`	Arbitrary key-value pairs for additional properties

---
name: my-skill
description: What this skill does
license: Apache-2.0
model: sonnet
allowed-tools: Read Grep Glob
---

References

License

Apache-2.0

mpuig/skills