Skills

Production-ready skills for AI coding agents. Tool-agnostic by design.

Available Skills

Skill	Description
agent-readiness	Evaluate codebase readiness for AI agents (Factory.ai aligned)

Quick Start

# Install skill
git clone https://github.com/mneves75/skills.git ~/.claude/skills/mneves-skills

# Run assessment
cd your-project
readiness-check

Installation

pi

git clone https://github.com/mneves75/skills.git ~/.pi/agent/skills/mneves-skills

OpenCode

git clone https://github.com/mneves75/skills.git ~/.config/opencode/skills/mneves-skills

Claude Code

git clone https://github.com/mneves75/skills.git ~/.claude/skills/mneves-skills

Cursor

git clone https://github.com/mneves75/skills.git ~/.cursor/skills/mneves-skills

VS Code (with AI extensions)

git clone https://github.com/mneves75/skills.git ~/.vscode/skills/mneves-skills

Codex / OpenAI

# Via OpenSkills
npx openskills add mneves75/skills

# Manual
git clone https://github.com/mneves75/skills.git ~/.agent/skills/mneves-skills

Windsurf / Aider / Other Tools

git clone https://github.com/mneves75/skills.git ~/.agent/skills/mneves-skills

Benchmark Examples

Real assessments of popular open-source projects. View Live Reports →

Project	Language	Level	Score	Report
FastAPI	Python	L4	65.4%	View

See examples/ for live reports.

Skill Locations

Skills are discovered in these locations (priority order):

Location	Scope	Tool
./.agent/skills/	Project	Universal
~/.agent/skills/	Global	Universal
./.pi/skills/	Project	pi
~/.pi/agent/skills/	Global	pi
./.opencode/skills/	Project	OpenCode
~/.config/opencode/skills/	Global	OpenCode
./.claude/skills/	Project	Claude Code
~/.claude/skills/	Global	Claude Code
~/.cursor/skills/	Global	Cursor
~/.vscode/skills/	Global	VS Code

Contributing

See CONTRIBUTING.md.

License

Apache-2.0

Acknowledgments

This project is inspired by Factory.ai's Code Readiness framework. Factory.ai pioneered the approach of evaluating codebases for AI agent compatibility using structured pillars and maturity levels. Their commercial tool set the standard for what "agent-ready" means.

Related

• Anthropic Skills - Official specification
• pi coding agent - Open-source coding agent with skills support
• OpenCode - Terminal-based AI coding assistant with skills support
• OpenSkills - Universal skills loader
• skills.sh - Skill registry