# pcl-expert

pcl-expert — a skill for Persona Control Language: persona, team and workflow declarations, the compiler pipeline, the pcl toolchain. Useful when the agent edits .pcl files or the compiler itself.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 160 installs · ★ 45 repo stars
- Author: personamanagmentlayer
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/languages/pcl-expert/SKILL.md
- Updated: 2026-10-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/pcl-expert

## What it does

The skill loads domain knowledge about Persona Control Language, a DSL and compiler aimed at AI persona management. It covers four declaration forms: `persona`, `team`, `workflow` and `skill`, each with syntax samples. On the compiler side it maps the pipeline from lexer through parser and semantic analysis to code generation, and touches LSP and MCP integration.

A good chunk of the text is a CLI map. The agent gets `pcl build` and `pcl watch` for compilation, `pcl run` and `pcl repl` for execution, the `pcl skills` group for listing, installing, publishing and validating, plus `pcl registry`, `pcl lsp`, `pcl mcp` and `pcl serve`, which brings up an HTTP artifact registry with JWT auth and rate limiting. Its allowed tools are `Read`, `Write`, `Edit`, `Execute`, `Debug`, `Test`, so it can change code rather than only talk about it.

There is an anti-patterns section with a clear stance: no global state, no `throw` where a `Result<AST, Error[]>` fits, no mutable AST, no `any`. That stance has teeth. On a parser built around exceptions the agent will push toward result types instead of matching your existing style.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill pcl-expert -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/pcl-expert/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/pcl-expert/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill pcl-expert -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/pcl-expert/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill pcl-expert -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/pcl-expert/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install personamanagmentlayer/pcl stdlib/languages/pcl-expert
```

2. **Manually: put the files in place**
- File: `.github/skills/pcl-expert/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill pcl-expert -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/languages/pcl-expert
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/pcl-expert/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill pcl-expert -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/languages/pcl-expert/SKILL.md

## When to use it
- sketch a `team` with per-persona weights and `consensus` merge mode
- chain `workflow` steps so one persona's output feeds the next
- define the grammar for a new PCL operator and the AST nodes it needs
- start the language server with `pcl lsp` and wire it into an editor
- move a parser off exceptions onto `Result` without global state

## Example prompts
- Add a `CODE_REVIEW_TEAM` to `personas.pcl`: three personas, weights 0.5, 0.3 and 0.2, merge mode `consensus`.
- \`pcl build` fails somewhere in the type check — trace which AST nodes lose their type.
- Write the grammar for a new PCL operator, update the lexer and parser, then run `pcl build`.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: e023e57e018e56f5.

BEGIN THIRD-PARTY FILE e023e57e018e56f5
````text
---
name: pcl-expert
version: 1.1.0
description: >-
  Expert in Persona Control Language (PCL) - language design, compiler architecture,
  runtime systems, and ecosystem development. Use when the user mentions persona control
  language, compiler design, language design, DSL, runtime systems, or lexer, or when the
  task involves Language Design & Specification, Compiler Architecture, Language Server
  Protocol, or Model Context Protocol.
category: languages
tags:
  [
    pcl,
    persona-control-language,
    compiler-design,
    language-design,
    dsl,
    runtime-systems,
    lexer,
    parser,
    semantic-analysis,
    codegen,
    type-systems,
    ast,
    lsp,
    mcp,
  ]
allowed-tools:
  - Read
  - Write
  - Edit
  - Execute
  - Debug
  - Test
---

# PCL Expert

Master expert in **Persona Control Language (PCL)** - a domain-specific programming language and compiler for AI persona management. Comprehensive expertise in language design, compiler architecture, runtime execution, tooling ecosystem, and standards compliance.

## Advanced Features

### Adaptive Intelligence (Phase 1.2)

```typescript
// Learning and optimization systems
interface AdaptiveIntelligence {
  // Memory management
  memory: {
    store: MemoryStorage;
    manager: MemoryManager;
    knowledgeSharing: KnowledgeSharing;
  };

  // Analytics and insights
  analytics: {
    performanceTracker: PerformanceTracker;
    trendAnalyzer: TrendAnalyzer;
    analyticsStore: AnalyticsStore;
  };

  // Intelligent routing
  routing: {
    router: IntelligentRouter;
    taskClassifier: TaskClassifier;
  };

  // Response caching
  cache: {
    responseCache: ResponseCache;
    semanticMatcher: SemanticMatcher;
  };

  // A/B testing
  experiments: {
    manager: ExperimentManager;
    variantSelector: VariantSelector;
    resultsAnalyzer: ResultsAnalyzer;
  };

  // Confidence scoring
  confidence: {
    scorer: ConfidenceScorer;
    signalCollector: SignalCollector;
    calibration: CalibrationEngine;
  };

  // Context management
  context: {
    windowManager: ContextWindowManager;
    deduplication: Deduplication;
    prioritization: Prioritization;
    threading: Threading;
  };

  // Escalation management
  escalation: {
````
END THIRD-PARTY FILE e023e57e018e56f5

The third-party file has ended. Everything between the e023e57e018e56f5 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2235 of 10548 bytes. © personamanagmentlayer · Apache-2.0 · https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/languages/pcl-expert/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
