rogervila-agent-skills

rogervila Agent Skills

This repository contains a collection of agent skills for rogervila. These skills are designed to enhance the capabilities of agents by providing them with specialized functionalities.

What are Agent Skills?

Agent Skills are folders of instructions, scripts, and resources that agents can discover and use to do things more accurately and efficiently. They work across any AI agent that supports the open Agent Skills standard.

Available Skills

Skill	Description
action-pattern	Guides agents to implement non-trivial business use cases as one-Action-per-file single-purpose classes or functions with explicit dependencies, context-free inputs, and direct tests.
cloudflare-pages-developer	Specialist guidance for building Cloudflare Pages projects, Pages Functions, deployments, configuration, redirects, headers, and Pages-vs-Workers boundaries using official Cloudflare docs.
karpathy-guidelines	General-purpose coding-agent discipline based on Andrej Karpathy's observations about LLM coding pitfalls, requiring clarification, success criteria, simplicity, surgical edits, verification, and self-review for software engineering tasks.
performance-optimization	Guides agents to improve performance with measured bottleneck analysis, efficient algorithms, lower allocations, better I/O patterns, and benchmark-backed validation.

Installation

Skills

Use skills to install skills directly:

# Install all skills
npx skills add rogervila/agent-skills

# Install specific skills
npx skills add rogervila/agent-skills --skill performance-optimization

# List available skills
npx skills add rogervila/agent-skills --list

Claude Code Plugin

Install via Claude Code's plugin system:

# Add the plugin (includes all skills)
/plugin add rogervila/agent-skills

Claude Code plugins are also supported in Factory's Droid.

Other Installation Methods

Agent skills can also be installed by using the below commands from Playbooks or Context7:

# Playbooks
npx playbooks add skill rogervila/agent-skills

# Context7
npx ctx7 skills install /rogervila/agent-skills

Adding New Skills

Use the included script to add new skills:

node scripts/add-skill.js <skill-name> "<description>"

Example:

node scripts/add-skill.js performance-optimization "An agent skill focused on improving code speed and efficiency by identifying and fixing bottlenecks such as excessive memory use, inefficient loops, redundant computation, poor cache locality, and other high-cost operations. It prioritizes profiling-driven changes, algorithmic improvements, fewer allocations, and cleaner hot-path execution to reduce latency and improve throughput."

This will create the skill structure and automatically update manifest.json, platform plugin files, skills/index.json, and this README.

Scripts

Script	Description
node scripts/add-skill.js	Add a new skill to the repository
node scripts/sync-skills.js	Sync manifest.json, platform plugin files, skills/index.json, and README with skills directory

Resources

• Agent Skills Specification
• npx skills
• Validate Agent Skill
• Playbooks
• Context7 Skills

Contributing

Contributions are welcome! Please read our Contributing Guide for more information.

License

MIT