Pnpm Format
Developmentpnpm-formatPnpm Format is an Agent Skill for development published in the microsoft/typespec repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Format the codebase with pnpm and recover from common formatting failures.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/microsoft/typespec/blob/HEAD/.github/skills/pnpm-format/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/pnpm-format, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Format code with pnpm
Use this skill any time formatting is required in the TypeSpec repo. Do not assume formatting happens automatically; always run pnpm format following this guidance.
Preconditions
- Command must run from the repository root (where
package.jsonandpnpm-workspace.yamllive). - Dependencies must be installed.
Steps
- Confirm you are at the repo root.
- If
node_modulesare missing orpnpmcomplains about missing packages, run:pnpm install - Run the formatter:
pnpm format - If the command fails with
ERR_PNPM_NO_IMPORTER_MANIFEST_FOUND, you are not at the repo root.cdto the root and retry. - If
pnpm formatexits with a non-zero code but prints a list of changed files, re-runpnpm formatonce to ensure a clean exit.
Notes
- Do not cancel the command; formatting may take about a minute.