Modern Admin Skills

AI agent skills for the Modern Admin framework, in the Agent Skills format. They give AI coding assistants (Claude Code, Cursor, Copilot, Windsurf, Aider, opencode, Kiro, …) the framework's non-obvious integration rules so you don't have to re-discover them by reading the source.

Each skill loads lazily based on its description frontmatter — there's no context cost unless a task actually touches Modern Admin.

Install

In any project where you use an AI coding agent:

npx skills add modern-admin/skills

The CLI clones this repo, lists the skills under skills/, and walks you through:

1. Pick skills to install (space to toggle).
2. Pick agents — Claude Code, Cursor, GitHub Copilot, Windsurf, Aider, opencode, Kiro, …
3. Pick scope — project (./.claude/skills/, …) or global (~/.claude/skills/, …).

npx skills writes a skills-lock.json at your project root with the resolved source and a content hash for every installed skill, so teammates and CI restore the same files later:

npx skills experimental_install   # like `npm ci` — restore from lock

Non-interactive, single-skill, or pinned-to-version install:

npx skills add modern-admin/skills --skill modern-admin-integration --yes
npx skills add modern-admin/skills#v2.0.0

Claude Code users can also install via the plugin mechanism:

/plugin install modern-admin/skills

Skills in this repo

Skill	What it covers
modern-admin-integration	Wiring ModernAdminModule.forRoot, adding resources, Better Auth + Prisma + Redis setup, declaring properties, @Action/@Before/@After hooks, role permissions via MaRole.permissions, the 14 Ma* Prisma models, auth/SPA 404 troubleshooting, the i18n / UUID v7 / mobile-first conventions.

Contributing

See AGENTS.md for the repo layout, skill file format, validation, and release process.

License

MIT. See LICENSE.