{"_id":"@balazsbarta/mp-skills","_rev":"4-9eb0efb5f653c2d583f93632405857f8","name":"@balazsbarta/mp-skills","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@balazsbarta/mp-skills","version":"0.1.0","license":"MIT","_id":"@balazsbarta/mp-skills@0.1.0","maintainers":[{"name":"balazsbarta","email":"info@hellobala.hu"}],"bin":{"skills":"scripts/skills.mjs"},"dist":{"shasum":"7653578fb81a6464133ab99ef5b840e0aaa65266","tarball":"https://registry.npmjs.org/@balazsbarta/mp-skills/-/mp-skills-0.1.0.tgz","fileCount":80,"integrity":"sha512-2k+FC8gJ36k5PkVskGPww04KVo1C9dFtvSiFpVUgTnQ5mEsDhPR5N4hInri4VIIUDDn5vuWcqNFmEi5q/S4cwg==","signatures":[{"sig":"MEYCIQC88SHfBem6k02HquMOq4SAPb4vMpSSA4/kIVwGlkBjsQIhAK0jL3FIn259CdWkMEYIbFednOkfkHF6Yt4Dpqku2MvF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":323159},"type":"module","gitHead":"6d3adfb61b29fce53fe4c84394f50ccbed11014d","scripts":{"skills":"node ./scripts/skills.mjs","validate":"npm run validate:project","validate:project":"node ./scripts/validate-project.mjs"},"_npmUser":{"name":"balazsbarta","email":"info@hellobala.hu"},"_npmVersion":"11.10.0","description":"Reusable skill packs for coding agents.","directories":{},"_nodeVersion":"22.19.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mp-skills_0.1.0_1771276864996_0.2959088567849495","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@balazsbarta/mp-skills","version":"0.1.1","license":"MIT","_id":"@balazsbarta/mp-skills@0.1.1","maintainers":[{"name":"balazsbarta","email":"info@hellobala.hu"}],"bin":{"skills":"scripts/skills.mjs"},"dist":{"shasum":"1d91ff744e99befe641097be398cf9cfe4d25630","tarball":"https://registry.npmjs.org/@balazsbarta/mp-skills/-/mp-skills-0.1.1.tgz","fileCount":80,"integrity":"sha512-78XnCduVFAQYtJiDqXcK7uAaqWyQC5sH8XOZ0Kz0jNIgvW5Ch5QFDCApsK4GuHIRT12I/gt711mKtUm2udHm/g==","signatures":[{"sig":"MEUCIG6ebf3FAvBU7bmflNVl9X0GpsUUXOChK8ch34/XibZ5AiEApxCE7eZYPMBsM4zvSLMVGYKdU31uAZ2xh1+3bNVk/Z0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":318623},"type":"module","gitHead":"a63cb48b69cc4ecc286d971d9de74986d4c40464","scripts":{"skills":"node ./scripts/skills.mjs","validate":"npm run validate:project","validate:project":"node ./scripts/validate-project.mjs"},"_npmUser":{"name":"balazsbarta","email":"info@hellobala.hu"},"_npmVersion":"11.10.0","description":"Reusable skill packs for coding agents.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"@clack/prompts":"^1.0.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mp-skills_0.1.1_1771278490943_0.9287207698053783","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@balazsbarta/mp-skills","version":"0.1.4","license":"MIT","_id":"@balazsbarta/mp-skills@0.1.4","maintainers":[{"name":"balazsbarta","email":"info@hellobala.hu"}],"bin":{"skills":"scripts/skills.mjs"},"dist":{"shasum":"cf7c913cd882580506c05b7bb7900b1853cc2014","tarball":"https://registry.npmjs.org/@balazsbarta/mp-skills/-/mp-skills-0.1.4.tgz","fileCount":89,"integrity":"sha512-AT1tp/s+QAbBKSSyTkc+q68wm3kvyP1dtqVg/Sb2GqwSF87PYl/XfgqqUqXboa34GLSL5l2NEjCD5OcBOKIdFw==","signatures":[{"sig":"MEUCIQDjeppqsKMKWMpV+OGgOQ39DrpVQH5KZ9tGgcyvGTYtfAIgcq5Eh6obW9rVzp62tJOPZFi1IbhXMM3HROAIgD9km/s=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":340560},"type":"module","gitHead":"3fecdf38581c2e99b2840ced4fd058427fe215ca","scripts":{"skills":"node ./scripts/skills.mjs","validate":"npm run validate:project","skill:scaffold":"node ./scripts/skill-scaffold.mjs","validate:project":"node ./scripts/validate-project.mjs"},"_npmUser":{"name":"balazsbarta","email":"info@hellobala.hu"},"_npmVersion":"11.10.0","description":"Reusable skill packs for coding agents.","directories":{},"_nodeVersion":"22.19.0","dependencies":{"@clack/prompts":"^1.0.1"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mp-skills_0.1.4_1771330026947_0.6768073473170173","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@balazsbarta/mp-skills","version":"0.2.0","description":"Reusable skill packs for coding agents.","license":"MIT","type":"module","bin":{"skills":"scripts/skills.mjs"},"scripts":{"skills":"node ./scripts/skills.mjs","skill:scaffold":"node ./scripts/skill-scaffold.mjs","validate:project":"node ./scripts/validate-project.mjs","validate":"npm run validate:project"},"dependencies":{"@clack/prompts":"^1.0.1"},"gitHead":"f9eb3ea60c468a0305fd7355b141d89992a96464","_id":"@balazsbarta/mp-skills@0.2.0","_nodeVersion":"22.19.0","_npmVersion":"11.11.1","dist":{"integrity":"sha512-fpRLF6N/d31wQurbuVZxOLzx6g9CDIefcrnOEigakeUz6jgjuD+QVCp2lrpSwTiWgL29whdChajhBzVvUwaIyw==","shasum":"008636f1f4e40992ef01a2ecb1a7c2053e210b94","tarball":"https://registry.npmjs.org/@balazsbarta/mp-skills/-/mp-skills-0.2.0.tgz","fileCount":95,"unpackedSize":363130,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDa8qqRfbG0XHsWMtoCMnYf17NLqdawb1zQM5RHqblH/QIhAIDHkh6D45tcghRWf+kV6lOR8xZDSU9ZnTP994SzsQ3Z"}]},"_npmUser":{"name":"balazsbarta","email":"info@hellobala.hu"},"directories":{},"maintainers":[{"name":"balazsbarta","email":"info@hellobala.hu"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mp-skills_0.2.0_1773681369754_0.4133726172298908"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-16T21:21:04.857Z","modified":"2026-03-16T17:16:10.011Z","0.1.0":"2026-02-16T21:21:05.153Z","0.1.1":"2026-02-16T21:48:11.083Z","0.1.4":"2026-02-17T12:07:07.133Z","0.2.0":"2026-03-16T17:16:09.911Z"},"license":"MIT","description":"Reusable skill packs for coding agents.","maintainers":[{"name":"balazsbarta","email":"info@hellobala.hu"}],"readme":"```\n /$$ /$$ /$$$$$$$ /$$$$$$ /$$ /$$ /$$ /$$ \n| $$$ /$$$| $$__ $$ /$$__ $$| $$ |__/| $$| $$ \n| $$$$ /$$$$| $$ \\ $$ | $$ \\__/| $$ /$$ /$$| $$| $$ /$$$$$$$\n| $$ $$/$$ $$| $$$$$$$/ | $$$$$$ | $$ /$$/| $$| $$| $$ /$$_____/\n| $$ $$$| $$| $$____/ \\____ $$| $$$$$$/ | $$| $$| $$| $$$$$$ \n| $$\\ $ | $$| $$ /$$ \\ $$| $$_ $$ | $$| $$| $$ \\____ $$\n| $$ \\/ | $$| $$ | $$$$$$/| $$ \\ $$| $$| $$| $$ /$$$$$$$/\n|__/ |__/|__/ \\______/ |__/ \\__/|__/|__/|__/|_______/ \n```\n---\n\nReusable, local-first skill library for coding agents. Install once, use across Claude Code, Codex, Gemini CLI, Cursor, OpenCode, and any agent that reads `SKILL.md` files. [Learn more](https://agentskills.io/).\n\n## What are skills?\n\nA skill is a self-contained directory that teaches a coding agent how to perform a specific task. Each skill directory contains:\n\n- **`SKILL.md`** — the primary instructions, workflow, and YAML frontmatter that the agent reads\n- **`references/`** — optional supporting docs loaded on demand (not all at once)\n- **`scripts/`** — optional helper automation\n\nThe `SKILL.md` frontmatter tells the agent what the skill does and when to use it. Here's a real example from the `brainstorming` skill:\n\n```yaml\n---\nname: brainstorming\ndescription: \"Facilitate structured technical brainstorming sessions. Use this skill to explore options, challenge assumptions, and produce implementation-ready plans for coding agents.\"\nlicense: MIT\nmetadata:\n plan_mode: \"true\"\n author: Balazs Barta\n version: \"2.2.0\"\n tags:\n - brainstorming\n - facilitation\n - decision-making\n - planning\n---\n```\n\nThe `description` field is how agents decide when to activate a skill — it's matched against the user's request or current context. Reference files in `references/` are loaded only when the skill's workflow calls for them, keeping context usage efficient.\n\nSkills follow the open [agentskills.io](https://agentskills.io) spec.\n\n## How agents use skills\n\nDifferent agents discover and invoke skills in different ways:\n\n| Agent | How to invoke | Auto-activation | Skill directory |\n| ----------- | ------------------------------------------------------------ | ------------------------------------------- | ------------------- |\n| Claude Code | Slash commands (`/skill-name`) or automatic context matching | Yes — matches `description` to current task | `.claude/skills/` |\n| Codex | Automatic context matching or explicit invocation | Yes — matches `description` to current task | `.codex/skills/` |\n| Gemini CLI | Native `SKILL.md` discovery, context-based | Yes — reads `SKILL.md` files automatically | `.gemini/skills/` |\n| Cursor | Native `SKILL.md` discovery, context-based | Yes — reads `SKILL.md` files automatically | `.cursor/skills/` |\n| OpenCode | Context-based discovery | Yes — matches `description` to current task | `.opencode/skills/` |\n\n**`plan_mode` frontmatter:** For validator compatibility, set plan mode as `metadata.plan_mode: \"true\"` (not as a top-level field). Agents that support a dedicated plan mode (like Claude Code) will enter it automatically.\n\n**Skill cross-references:** Skills can reference other skills using relative paths (e.g., `../task-breakdown/SKILL.md`). This lets one skill hand off to another — for example, `brainstorming` can hand off to `task-breakdown` for detailed implementation planning. **Note:** Cross-referencing skills require the full pack to be installed. If you install only a subset, relative-path links between skills will break silently.\n\n## Brainstorming artifacts (`ai-docs`)\n\nThe `brainstorming` skill persists its session output in `ai-docs/` and uses a helper script to create deterministic folders/files.\n\n### Script\n\n```bash\n.agents/skills/brainstorming/scripts/init_ai_docs.sh \"\"\n```\n\nThis creates:\n\n```text\nai-docs/\n brainstorming/\n -/findings.md\n task-breakdown/\n -/tasks.md\n```\n\n### Session closeout behavior\n\n1. Complete brainstorming in plan mode.\n2. Exit plan mode.\n3. Run the script above.\n4. Write finalized findings to `findings.md`.\n5. Ask whether to use `.agents/skills/task-breakdown/SKILL.md` for task generation.\n\nIf `.agents/skills/task-breakdown/SKILL.md` is not installed, continue with a manual task list in `tasks.md` or install the skill first.\n\n## Available skills\n\nEach skill's `description` determines when agents activate it. Browse the full list:\n\n| Skill | Description |\n| ------------------------ | ---------------------------------------------------------------------------------------------- |\n| `accessibility-standards` | Accessibility standards guide for WCAG/WACG, a11y audits, remediation patterns, and testing. |\n| `brainstorming` | Facilitate structured technical brainstorming sessions and produce implementation-ready plans. |\n| `conventional-commits` | Conventional Commits guide for commit format, scopes, and automated release workflows. |\n| `debugging` | Structured debugging workflow using Diagnose-Propose-Confirm with evidence-based diagnosis. |\n| `documentation` | AI-assisted documentation drafting using Draft-Review-Refine anchored to source material. |\n| `jest` | Jest testing guide for config, mocking, snapshots, transforms, and common issues. |\n| `maestro` | Maestro mobile E2E testing guide for flows, assertions, and CI usage. |\n| `mastra` | Mastra framework guide for current API usage, docs lookup, and agent/workflow patterns. |\n| `next-js` | Next.js App Router guide for routes, caching, metadata, and common errors. |\n| `playwright` | Playwright E2E guide for page objects, fixtures, CI, and visual regression. |\n| `pull-request-lifecycle` | Deterministic pull request workflow with changelog/version handling. |\n| `react-native-expo` | React Native + Expo guide for navigation, native modules, and EAS workflows. |\n| `supabase` | Supabase guide for auth, RLS, migrations, Edge Functions, and storage. |\n| `task-breakdown` | Task decomposition and estimation guide for epics, stories, and implementation tasks. |\n| `vitest` | Vitest testing guide for config, mocking, component tests, and coverage. |\n\n## Install\n\nThis repo ships a `skills` CLI (`scripts/skills.mjs`) so you can install to different assistants with one command.\n\n### Quick install\n\nFor installation, run the following command:\n\n```\nnpx @balazsbarta/mp-skills add mp-skills\n```\n\nTargets:\n\n- `codex`\n- `claude-code`\n- `opencode`\n- `gemini-cli`\n- `cursor`\n- `generic` (for other agents; defaults to `.agents/skills/`)\n- `all`\n\nUseful options:\n\n- `--mode copy|symlink` (default: `copy`)\n- `--global` — install to global home directories instead of project-local paths\n- `--cursor-project /path/to/project` (used by `cursor`)\n- `--dest /path/to/skills` (used by `generic`)\n\nInstall paths (default: project-local):\n\n| Target | Local (default) | Global (`--global`) |\n| ------------- | ------------------------------------- | ---------------------------- |\n| `codex` | `/.codex/skills/` | `~/.codex/skills/` |\n| `claude-code` | `/.claude/skills/` | `~/.claude/skills/` |\n| `opencode` | `/.opencode/skills/` | `~/.config/opencode/skills/` |\n| `gemini-cli` | `/.gemini/skills/` | `~/.gemini/skills/` |\n| `cursor` | `/.cursor/skills/` | (always project-local) |\n| `generic` | `/.agents/skills/` (or `--dest`) | (uses `--dest`) |\n\nMode behavior:\n\n- `symlink` applies to all folder-based targets (`codex`, `claude-code`, `opencode`, `gemini-cli`, `cursor`, `generic`)\n\n### Manual installs\n\n#### Codex\n\nCopy install:\n\n```bash\nSKILLS_HOME=\".codex/skills\"\nmkdir -p \"$SKILLS_HOME\"\ncp -R .agents/skills/* \"$SKILLS_HOME/\"\n```\n\nSymlink install:\n\n```bash\nSKILLS_HOME=\".codex/skills\"\nmkdir -p \"$SKILLS_HOME\"\n\nfor dir in .agents/skills/*; do\n name=\"$(basename \"$dir\")\"\n target=\"$SKILLS_HOME/$name\"\n\n if [ -e \"$target\" ] || [ -L \"$target\" ]; then\n rm -rf \"$target\"\n fi\n\n ln -s \"$(pwd)/$dir\" \"$target\"\ndone\n```\n\n#### Claude Code\n\nSkills are installed as folders in `.claude/skills//`.\n\n```bash\nCLAUDE_SKILLS_DIR=\".claude/skills\"\nmkdir -p \"$CLAUDE_SKILLS_DIR\"\n\nfor dir in .agents/skills/*; do\n name=\"$(basename \"$dir\")\"\n ln -sfn \"$(pwd)/$dir\" \"$CLAUDE_SKILLS_DIR/$name\"\ndone\n```\n\n#### OpenCode\n\nOpenCode skills are installed to `.opencode/skills/` by default.\n\n```bash\nOPENCODE_SKILLS_DIR=\".opencode/skills\"\nmkdir -p \"$OPENCODE_SKILLS_DIR\"\n\nfor dir in .agents/skills/*; do\n name=\"$(basename \"$dir\")\"\n ln -sfn \"$(pwd)/$dir\" \"$OPENCODE_SKILLS_DIR/$name\"\ndone\n```\n\n#### Gemini CLI\n\nGemini CLI skills are installed to `.gemini/skills/` by default. Gemini CLI discovers `SKILL.md` files natively.\n\n```bash\nGEMINI_SKILLS_DIR=\".gemini/skills\"\nmkdir -p \"$GEMINI_SKILLS_DIR\"\n\nfor dir in .agents/skills/*; do\n name=\"$(basename \"$dir\")\"\n ln -sfn \"$(pwd)/$dir\" \"$GEMINI_SKILLS_DIR/$name\"\ndone\n```\n\n#### Cursor / Cursor CLI\n\nCursor skills are installed to `.cursor/skills/`. Cursor discovers `SKILL.md` files natively.\n\n```bash\nCURSOR_SKILLS_DIR=\".cursor/skills\"\nmkdir -p \"$CURSOR_SKILLS_DIR\"\n\nfor dir in .agents/skills/*; do\n name=\"$(basename \"$dir\")\"\n ln -sfn \"$(pwd)/$dir\" \"$CURSOR_SKILLS_DIR/$name\"\ndone\n```\n\nOr use the installer for a different project directory:\n\n```bash\nnpx @balazsbarta/mp-skills add mp-skills --target cursor --cursor-project /path/to/project\n```\n\n#### Other agents\n\nUse the `generic` target to install skill folders to any custom location:\n\n```bash\nnpx @balazsbarta/mp-skills add mp-skills --target generic --dest /path/to/agent/skills --mode symlink\n```\n\nOr use the default `.agents/skills/` location:\n\n```bash\nnpx @balazsbarta/mp-skills add mp-skills --target generic\n```\n\n## Verify install\n\nCodex:\n\n```bash\nls -la .codex/skills\n```\n\nClaude Code:\n\n```bash\nls -la .claude/skills\n```\n\nOpenCode:\n\n```bash\nls -la .opencode/skills\n```\n\nGemini CLI:\n\n```bash\nls -la .gemini/skills\n```\n\nCursor:\n\n```bash\nls -la .cursor/skills\n```\n","readmeFilename":"README.md"}