ngautopilot
Use when an AI coding agent needs NgAutoPilot routing, version-aware Angular guidance, frontend quality gates, skill catalog maintenance, plugin bundle validation, or safe agent adapter installation.
SKILL.mdSKILL.md
GitHubNgAutoPilot
Purpose
Use this root skill as the public entry point for NgAutoPilot. It explains how to approach a repository with the NgAutoPilot catalog, packs, adapters, plugin bundles, and validation gates.
NgAutoPilot is an agent-agnostic engineering toolkit for bounded Angular, TypeScript, JavaScript, frontend, and quality work. It is not an autopatcher, framework, runtime dependency, or replacement for tests and review.
When to Use
Use this skill when:
- You are installing or using NgAutoPilot in an agent workspace.
- You need to choose an NgAutoPilot pack, adapter, or plugin bundle.
- You are maintaining the skill catalog, marketplace manifests, adapters, or bundle sync.
- You are doing Angular, frontend, TypeScript, JavaScript, RxJS, testing, quality, or upgrade work and need version-aware routing.
- You need a safe default workflow before selecting a more specific NgAutoPilot skill.
Inputs Expected
- User goal and affected area
- Repository stack and framework versions
- Package manager and available scripts
- Installed agent adapter or target agent
- Requested pack or plugin, if any
- Current validation requirements
Operating Model
Follow this loop:
Inspect repository -> detect stack and versions -> select smallest relevant skill -> assess compatibility and risk -> make the smallest reversible change -> validate with repository scripts -> report evidence and residual risk
Prefer focused packs over loading the full catalog. Every focused pack includes ngautopilot-core automatically.
Core Routing
Start with these concepts:
| Need | Use |
|---|---|
| General workflow | core.autopilot-orchestrator |
| Project shape and stack | core.project-intake, core.stack-version-detection |
| Skill selection | core.skill-router |
| Version safety | core.compatibility-router |
| Change risk | core.risk-assessment |
| Angular upgrades | angular.upgrades.angular-upgrade-orchestrator |
| Angular 21 to 22 | angular.versioning.angular-21-to-22-index |
| Quality work | quality.fundamentals.quality-decision-matrix |
Installation Entry Points
Use the CLI for bounded installation:
npm exec --package=ngautopilot -- ngautopilot adapters
npm exec --package=ngautopilot -- ngautopilot packs
npm exec --package=ngautopilot -- ngautopilot install --agent opencode --pack ngautopilot-angular-foundations --dry-run
Use marketplace/plugin discovery for browsing. Do not treat marketplace bundles as pack selection.
Maintenance Rules
- Preserve separation between source skills in
skills/and distributable bundles inplugins/. - Update source skills first, then sync plugin bundles.
- Do not invent Angular compatibility data, APIs, CLI commands, or validation results.
- Keep Angular upgrade hops separate from modernization work.
- Prefer the smallest reversible change.
- Do not add dependencies unless required by the task.
Validation
Use repository scripts that match the changed area:
npm run skills:validate
npm run skills:catalog
npm run security:scan
npm run release:validate
For Skill Lab changes, also run:
npm run skill-lab:validate
npm run skill-lab:test
npm run skill-lab:ci
Do
- Inspect before editing.
- Route through the smallest useful skill.
- Validate source and plugin bundles together when skill content changes.
- Report exact commands run and outcomes.
- Call out residual risks and unavailable checks.
Do Not
- Do not broadly refactor when a narrow fix works.
- Do not move or rename large skill trees without a migration plan.
- Do not mix multiple Angular major hops into one validation gate.
- Do not publish, commit, or open pull requests unless explicitly requested.
- Do not treat
npx skills add janpereira-dev/ngAutoPilotas focused pack installation.
Expected Output
When this skill is used, return:
- Selected NgAutoPilot entry point or focused skill.
- Compatibility and risk notes.
- Files changed or inspected.
- Validation commands and results.
- Remaining risks or next safe step.