26.2 26.1
26.2 26.1

Skill Reference

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

node_modules/@pas/dev-guidelines/skills

The skills that PAS Code ships. Each skill has its own folder with a SKILL.md file.

.claude/skills or .agents/skills

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.

.pas/skills

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.

pas-spec-driven-development

Specification

You and your assistant write the SPEC.md file that describes what the code must achieve.

pas-generate-specification

Code

Your assistant implements the approved specification.

  • pas-generate-code

  • pas-integrate-openapi

Code: Scaffolding

Your assistant creates a project, a service, an app, an agent, or a bundle deployment with the PAS CLI.

  • pas-generate-project

  • pas-generate-service

  • pas-generate-app

  • pas-generate-agent

  • pas-generate-bundle-deployment

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.

pas-integrate-authentication

Documentation

Your assistant writes the README.md and AGENTS.md files that describe how the code is used.

pas-generate-documentation

Local Setup and Start

Your assistant checks the Node.js and npm versions, installs the dependencies, and points you to pas start.

pas-project-startup

Review

Your assistant reviews the pending changes against the governing SPEC.md files and the PAS rules, and ends with a merge-readiness verdict.

pas-code-review

Commit and Push

Your assistant writes commit messages according to the PAS git rules and pushes a branch to an explicitly named destination.

pas-git

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.md file and

  • a reference folder

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.md file.

  • 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

pas-configure-platform-mcp

Your assistant reads the address of the platform MCP server of the active platform with pas platform mcp info, writes the server into the project configuration of each assistant you choose, and commits the configuration. Refer to Connecting to the Platform MCP Server for details.

📗
📘

Related Documentation: