PAS Code is delivered with a set of skills for AI coding assistants. Every project that you create with pas new contains these skills, and your assistant uses them for the tasks of the PAS Code development workflow, from the specification of a change to the review of the result.
Where to Find the PAS Code Skills
The skills of PAS Code are part of the package @pas/dev-guidelines. After npm install, you find skills in your project in these locations:
|
Location |
Content |
|---|---|
|
|
The skills that PAS Code ships. Each skill has its own folder with a |
|
|
The linked copies that your AI coding assistant reads. The folder depends on the coding assistant. After each update of PAS Code, the skills are linked into these folders. |
|
|
The skills that you write for your own project. |
Read the skills to see which procedure your assistant follows. Do not edit the linked copies.
For further details on skill availability, skill sources and how to link skills, refer to Working With Skills.
PAS Code Skills in the Development Workflow
The default development workflow of PAS Code is spec-driven development. It has three phases in a fixed order, and each phase ends with your explicit approval. The following table assigns the skills to the phases and to the steps around them:
|
Phase/Step |
What Happens |
Skills |
|---|---|---|
|
Entire workflow |
The skill runs the three phases in order and asks for your approval at the end of each phase. |
|
|
Specification |
You and your assistant write the |
|
|
Code |
Your assistant implements the approved specification. |
|
|
Code: Scaffolding |
Your assistant creates a project, a service, an app, an agent, or a bundle deployment with the PAS CLI. |
|
|
Code: Authentication |
Your assistant adds authentication to an app or a service: the sign-in of an app, the access token check of a service, public routes, and the roles a route requires. |
|
|
Documentation |
Your assistant writes the |
|
|
Local Setup and Start |
Your assistant checks the Node.js and npm versions, installs the dependencies, and points you to |
|
|
Review |
Your assistant reviews the pending changes against the governing |
|
|
Commit and Push |
Your assistant writes commit messages according to the PAS git rules and pushes a branch to an explicitly named destination. |
|
Example
The skill pas-spec-driven-development carries the default development workflow of PAS Code. It shows the typical structure of a skill:
-
a folder that is named like the skill
-
the folder contains a
SKILL.mdfile and -
a
referencefolder
pas-spec-driven-development/
SKILL.md
reference/
workflow.md
The following excerpt shows the beginning of the SKILL.md file. The mark [...] replaces passages that are omitted here:
---
name: pas-spec-driven-development
description: Use for ANY request to add, extend, modify, refactor, rename, or clean up a feature in this monorepo — the default development workflow. The spec MUST be written and approved before any code. Load before pas-generate-code / any code-writing. Also applies in Plan Mode (first plan step = create/update SPEC.md).
---
# Spec-Driven Development
This skill drives feature work through a strict three-phase workflow —
**SPEC → CODE → DOCUMENTATION** — where each phase ends with an explicit user approval gate.
[...]
- **Step 1 (SPEC)** → `pas-generate-specification` (its `reference/specification-rules.md`).
- **Step 2 (CODE)** → `pas-generate-code` (its `reference/` topic files, indexed by its `SKILL.md`).
- **Step 3 (DOCUMENTATION)** → `pas-generate-documentation` (its `reference/documentation-rules.md`).
[...]
When your assistant loads the skill, it behaves as follows:
-
It loads the skill before any feature work, including work that starts as a plan. A plan starts with the step to create or update the
SPEC.mdfile. -
It names the skill and the current step.
-
It calls the skill of each phase, so the rules of the phase are in context.
-
It never advances a phase without your explicit approval.
Skills Outside the Development Workflow
The following skill prepares your development environment. It is not part of a phase of the workflow:
|
Skill |
What Happens |
|---|---|
|
|
Your assistant reads the address of the platform MCP server of the active platform with |
Related Content
Related Documentation: