Skip to content

PLAYBOOK.md

Spec Website Spec License: CC BY 4.0 Code License: MIT

An open specification for multi-step AI workflows written in plain markdown.

PLAYBOOK.md defines a portable, human-readable format for repeatable AI workflows. If you can write a README, you can write a playbook.

Repositories

Repo Description
playbook-spec The PLAYBOOK.md specification
playbook-gallery Curated example playbooks
playbook-schema JSON Schema and TypeScript types
playbook-integrations SDKs (TS, Python, Go), MCP server, Agent Skills, Editor configs
playbook-playground Web-based editor and validator
playbook-cli CLI tool for validating, parsing, and scaffolding playbooks
playbook-vscode VS Code extension with syntax highlighting and validation
playbook-action GitHub Action for PR validation
playbook-docs Documentation site (docs.playbook.style)
playbook-site Landing page (playbook.style)

Tooling

CLI

npm install -g @playbook-md/cli

VS Code Extension

code --install-extension playbook-md.playbook-vscode

GitHub Action

- uses: PLAYBOOK-MD/playbook-action@v1

Quick Example

# Code Review Pipeline

## INPUTS

- `code` (text): Code to review
- `focus` (enum: security, performance, readability): Review focus

## STEP 1: Analysis

Analyze the following code with a focus on {{focus}}:
{{code}}

@output(issues)

## STEP 2: Recommendations

For each issue, provide a severity rating and specific fix.

Get Involved

  • Read the spec
  • Browse the gallery
  • Open an issue or discussion on any repo
  • Submit your own playbooks

License

Spec: CC BY 4.0 | Code: MIT

Pinned Loading

  1. playbook-spec playbook-spec Public

    Open specification for multi-step AI workflows written in plain markdown

    2 1

  2. playbook-integrations playbook-integrations Public

    Agent Skills, MCP server, and shared parser for PLAYBOOK.md

    TypeScript 1

  3. playbook-schema playbook-schema Public

    TypeScript types and JSON Schema for the PLAYBOOK.md specification

    TypeScript 1

  4. playbook-gallery playbook-gallery Public

    Curated collection of PLAYBOOK.md example playbooks

    1 1

Repositories

Showing 10 of 10 repositories

Top languages

Loading…

Most used topics

Loading…