Muninn Agent Skill 🐦‍⬛

This is a downloadable "Skill" that teaches your AI IDE Agent how to use the Muninn MCP.

What is this?

Even if you have the Muninn MCP server installed, your AI agent (Claude, GPT-4, etc.) doesn't instinctively know how or when to use it. This Skill Package provides the System Prompting and Operational Protocols to force the agent to:

1. Check the project context before coding.
2. Search semantically instead of guessing filenames.
3. Save important decisions to long-term memory.

Installation

🚀 The Easy Way (npx)

If you have Node.js installed, just run this in your project root:

npx @muninn/agent-skill

This will automatically detect your environment (Cursor, Windsurf, Antigravity, VSCode) and install the necessary rules.

📦 Manual Installation

If you prefer to copy files manually:

1. Windsurf / Codeium

Copy muninn-skill to ~/.windsurf/skills/muninn.

2. Cursor

Copy the contents of SKILL.md into .cursor/rules/muninn.mdc.

3. Antigravity

Copy the folder to .antigravity/skills/muninn.

4. Claude (CLAUDE.md)

Add the following to your CLAUDE.md:

Muninn Protocol: Use muninn.brain_check() at start, muninn.search_context() before coding, and muninn.add_memory() for decisions.

Usage

Once installed, you can simply tell your agent:

"Use the Muninn skill to orient yourself." "Save this conversation to Muninn memory."

The agent will automatically follow the protocols defined in SKILL.md.