# Openpencil Design Orchestrator

> Staged MCP-first Agent Skill for Pencil / OpenPencil design orchestration, section-safe edits, audits, and fallback-aware workflows.

- **Type:** MCP server
- **Install:** `agentstack add mcp-ziiinian-openpencil-design-orchestrator`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ziiinian](https://agentstack.voostack.com/s/ziiinian)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ziiinian](https://github.com/ziiinian)
- **Source:** https://github.com/ziiinian/openpencil-design-orchestrator

## Install

```sh
agentstack add mcp-ziiinian-openpencil-design-orchestrator
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# openpencil-design-orchestrator

**English** | [简体中文](./README.zh-CN.md)

[](https://github.com/ziiinian/openpencil-design-orchestrator/releases)
[](./LICENSE)
[](https://github.com/ziiinian/openpencil-design-orchestrator)

Controlled AI-assisted design workflow for Pencil / OpenPencil.

An Agent Skill for orchestrating Pencil / OpenPencil design work through a staged, MCP-first workflow.

## Quick Start

### Option 1 — Download the packaged skill
Go to the latest release and download:

- [`openpencil-design-orchestrator.skill`](https://github.com/ziiinian/openpencil-design-orchestrator/releases/latest)

### Option 2 — Inspect the source
Browse the skill source directly in this repository:

- `SKILL.md`
- `references/`
- `scripts/`

## Installation / Use

This repository ships both the **source skill** and a packaged `.skill` release artifact.

Typical usage flow:

1. Download the `.skill` artifact from the latest release
2. Install/import it into your skill environment
3. Use it when working with Pencil / OpenPencil design tasks that need staged, bounded execution

Typical trigger examples:

- “Use Pencil/OpenPencil to redesign this hero section, but do it section-by-section.”
- “Audit this design for spacing, typography, and token consistency before editing.”
- “Plan the page structure first, then create only the skeleton.”

## Install and verify

For installation and first-run verification, see:

- [Installation Guide](./docs/INSTALL.md)
- [简体中文安装说明](./docs/INSTALL.zh-CN.md)

For follow-up support materials, see:

- [Troubleshooting](./docs/TROUBLESHOOTING.md)
- [Usage Examples](./docs/EXAMPLES.md)
- [Evaluation Guide](./docs/EVALUATION.md)

## What it does

`openpencil-design-orchestrator` turns vague AI-assisted design requests into a controlled sequence of steps:

1. **Preflight** – verify Pencil/OpenPencil, MCP readiness, and current structure
2. **Planning** – break work into pages, sections, components, tokens, and execution order
3. **Skeleton** – build structural scaffolding only
4. **Section Content** – edit one section at a time with bounded scope
5. **Refinement** – improve spacing, hierarchy, consistency, and polish
6. **Save / Handoff** – summarize changes and remaining risks

The goal is to avoid uncontrolled one-shot design mutations and keep changes small, reviewable, and reversible.

## Best fit

Use this skill when you need to:

- work with Pencil / OpenPencil through MCP
- orchestrate AI-assisted design changes safely
- perform section-by-section design edits
- audit layout, consistency, spacing, tokens, and structure
- adapt workflows across Claude Code, Codex, Cursor, or Windsurf

## Not for

This skill is not the best primary path for:

- unconstrained whole-product one-shot generation
- blind large-scale destructive edits
- pretending live editing works when MCP is unavailable
- default-on high-risk automation via unrestricted `eval`

## Repository layout

```text
.
├── SKILL.md
├── README.md
├── README.zh-CN.md
├── references/
├── scripts/
├── dist/
│   └── openpencil-design-orchestrator.skill
├── source/
│   └── NOTICE.txt
└── LICENSE
```

## Key files

- `SKILL.md` – trigger description, workflow rules, operating constraints
- `references/` – prompt framework, workflow sequence, fallback mode, risk matrix, client adapters, capability notes
- `scripts/preflight-check.sh` – quick environment and MCP readiness check
- `scripts/scaffold-phase-prompt.py` – generate phase-specific prompt scaffolds
- `dist/openpencil-design-orchestrator.skill` – packaged distributable skill file

## Typical usage patterns

### 1. Build a new page safely
Example: “Create a SaaS landing page, but start with skeleton only.”

### 2. Revise one section without collateral damage
Example: “Only redesign the hero section; do not touch the rest.”

### 3. Audit an existing design
Example: “Review spacing, typography hierarchy, and token consistency before editing.”

## Roadmap

Possible future improvements:

- richer example prompts for more design scenarios
- more client-specific adapter notes
- expanded fallback examples for non-MCP workflows
- release notes for future versions beyond the initial public release

## Release

- Latest release: 
- First public release: 

## License

This repository is released under the MIT License. See [LICENSE](./LICENSE).

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ziiinian](https://github.com/ziiinian)
- **Source:** [ziiinian/openpencil-design-orchestrator](https://github.com/ziiinian/openpencil-design-orchestrator)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-ziiinian-openpencil-design-orchestrator
- Seller: https://agentstack.voostack.com/s/ziiinian
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.