Agent Skills for pragmatic, human-centered software development. Compatible with Claude Code, Cursor, Cline, OpenAI Codex, and other agents supporting the Agent Skills specification.

Subscribe to Web Reactiva Newsletter — Weekly insights on web development, AI tools, and the Malandriner philosophy.

The Malandriner Manifesto was born in the Web Reactiva community. It's a pragmatic, human-centered approach to software development in the AI era:

• Hands on the keyboard — Learning happens through practice, not theory
• Level up like it's a game — Make learning fun, celebrate small wins
• Your stumbles, my challenges — Every mistake becomes learning for all
• Break the bad rules — Build your own path, question dogma
• Speak Malandriner — Belong to a tribe that gets it

These skills bring this philosophy to your AI coding assistants.

npx skills add https://github.com/webreactiva-devs/malandriner-agents --skill malandriner-developer

Clone the repository and copy the desired skill folder to your agent's skills directory:

git clone https://github.com/webreactiva-devs/malandriner-agents.git
cp -r malandriner-agents/skills/malandriner-developer ~/.claude/skills/

malandriner-agents/
├── README.md                 # This file (repository index)
├── LICENSE                   # MIT License
├── .gitignore
└── skills/                   # All skills live here
    ├── README.md               # Skills index and comparison
    ├── malandriner-developer/  # Malandriner philosophy skill
    │   ├── SKILL.md            # Main skill instructions
    │   └── AGENTS.md           # Compiled guidelines
    ├── junior-ai-mentor/       # Junior AI mentorship skill
    │   ├── SKILL.md            # Main skill instructions
    │   ├── AGENTS.md           # Compiled guidelines
    │   └── references/         # Detailed reference docs
    │       ├── tools-comparison.md
    │       └── prompt-patterns.md
    ├── build-your-path/        # Learning-to-action planner
    │   └── SKILL.md            # Main skill instructions
    └── create-challenges/      # Bite-sized challenge creator
        └── SKILL.md            # Main skill instructions

1. Create a new directory under skills/:

mkdir -p skills/my-new-skill

2. Create the required SKILL.md with frontmatter:

---
name: my-new-skill
description: Description of what this skill does and when to use it.
license: MIT
metadata:
  author: your-name
  version: "1.0.0"
---

# My New Skill

Instructions for the agent...

3. (Optional) Add supporting files:

   • AGENTS.md - Compiled guidelines for agents
   • references/ - Detailed reference documentation

4. Update this README to include your new skill in the table.

Each skill follows the Agent Skills Specification:

• SKILL.md - Main skill file with YAML frontmatter and instructions

---
name: skill-name          # Must match directory name
description: "..."        # What it does and when to use it
---

---
license: MIT
metadata:
  author: your-name
  version: "1.0.0"
  category: mentorship
  tags: malandriner, web-reactiva, ai-development
---

These skills are compatible with:

Contributions are welcome! Please:

1. Fork the repository
2. Create a new skill in skills/your-skill-name/
3. Follow the Agent Skills Specification
4. Add your skill to the table in this README
5. Submit a pull request

• Keep SKILL.md under 500 lines (use references/ for detailed docs)
• Use progressive disclosure (metadata -> instructions -> references)
• Include clear examples in your instructions
• Embrace the Malandriner philosophy: practical, human-centered, no gatekeeping

MIT License - see LICENSE for details.

• Web Reactiva - Home of the Malandriner Community
• Web Reactiva Newsletter - Weekly insights
• Agent Skills Specification
• Skills.sh Directory

Built with love for the open web and the Malandriner Community of Web Reactiva

Made by Dani Primo — @webreactiva-devs