Skills

Reusable agent skills for AdonisJS, Lucid, Inertia, Japa, and full-cycle engineering orchestration.

Install

Guided Installer

Use the adonisjs-maestro CLI to install the right skills for your stack:

npx adonisjs-maestro

Non-interactive examples:

npx adonisjs-maestro --stack=vue --yes
npx adonisjs-maestro --stack=react --global --agent=codex --yes
npx adonisjs-maestro --skills=maestro,adonisjs,lucid,japa --yes

Available stacks:

| Stack | Skills | | --- | --- | | monorepo | maestro, adonisjs, lucid, japa | | hypermedia | maestro, adonisjs, lucid, japa, edge | | react | maestro, adonisjs, lucid, japa, inertia-react | | vue | maestro, adonisjs, lucid, japa, inertia-vue | | custom | Choose individual skills |

Direct Skills CLI

Install the collection with the skills CLI:

npx skills add lncitador/adonisjs-maestro

For a global install:

npx skills add lncitador/adonisjs-maestro -g --yes

Restart your agent after installing so the new skills are loaded.

Skills

| Skill | Use it for | | --- | --- | | maestro | Orchestrating full-cycle app work: intake, planning, implementation, verification, commit, push, and PR | | adonisjs | AdonisJS v7 backend work: migrations, models, transformers, controllers, routes, auth, policies, services, events, and review | | lucid | Lucid ORM and SQL layer: migrations, schema generation, models, relationships, query builders, transactions, factories, and seeders | | edge | Edge.js server-side templates in AdonisJS Hypermedia apps: layouts, components, forms, slots, and template state | | inertia-vue | Vue 3 frontend patterns in AdonisJS + Inertia projects | | inertia-react | React frontend patterns in AdonisJS + Inertia projects | | japa | Japa testing in AdonisJS apps: API tests, browser tests, console tests, fakes, swaps, and database setup |

In Progress

| Skill | Stack | Use it for | | --- | --- | --- | | tuyau | api-monorepo | Tuyau end-to-end type-safe API client: codegen, typed routes, and RPC-style calls |

Recommended Entry Point

Use maestro when the task is broader than a single framework question.

INTAKE -> PLANNING -> BUILD -> VERIFY -> PUBLISH -> DONE

Examples:

/maestro plan and implement this AdonisJS + Inertia feature.
/maestro review this PR against the implementation plan.
/maestro verify, commit, push, and open a PR for this change.

maestro coordinates the other skills instead of replacing them. For example, an AdonisJS + Inertia Vue task should usually combine:

• /maestro for phase control and workflow gates
• /adonisjs for backend contracts and routing
• /lucid for migrations, models, relationships, query builders, and factories
• /inertia-vue for frontend page/form patterns
• /japa for test strategy and fixtures

Direct Skill Usage

Use a specialized skill directly when the request is narrow:

/adonisjs create a controller, route, and validator for posts.
/lucid create a migration, model relationship, and factory for posts.
/japa write a functional test with loginAs.
/inertia-vue fix this Form component.
/inertia-react type these generated Data props.

Repository Layout

All skills live under skills/. Each folder contains a required SKILL.md file and optional resources:

skills/
├── maestro/
├── adonisjs/
├── lucid/
├── edge/
├── inertia-vue/
├── inertia-react/
└── japa/

The framework skills include references and runbooks for deeper context. The maestro skill intentionally has no scripts or references: it is an orchestration layer.

Development

Use the Skills CLI to search, install, check, and update skills:

npm run typecheck
npm run build
npx skills find adonisjs
npx skills check
npx skills update

Before publishing changes, make sure each skill folder contains a valid SKILL.md with YAML frontmatter:

---
name: skill-name
description: Use when...
---

Keep optional resources (references/, scripts/, assets/, agents/) only when they directly support the skill.

Release

Releases are created with release-it:

npm run release

The release command runs typecheck, tests, and build before bumping the package version, creating the release commit, and tagging it as v<version>. Pushing the tag triggers GitHub Actions to publish adonisjs-maestro to npm.

Configure npm Trusted Publishing for .github/workflows/publish.yml before the first release. The workflow uses GitHub OIDC instead of a long-lived npm token.

Notes

• These skills assume modern AdonisJS v7 conventions.
• lucid is focused on the ORM/database layer and should be paired with adonisjs for controllers, routes, validators, services, and framework-level architecture.
• inertia-vue and inertia-react are frontend-layer skills and should be paired with adonisjs for backend work.
• japa is focused on testing patterns for AdonisJS apps.
• maestro should be used when a task needs orchestration, phase gates, or publishing workflow discipline.