pencil-design-bridge
Bridge approved UI/UX direction briefs into Pencil design workflows without treating `.pen` files as plain text. Use when a project needs Pencil MCP/tool handoff, editable design exploration, design-system-aware canvas work, or review of Pencil outputs after senior-ui-ux-orchestrator, ui-ux-pro-max, Stitch, or Figma constraints are known.
How do I install this agent skill?
npx skills add https://github.com/sergekostenchuk/ui-ux-agent-skill-system --skill pencil-design-bridgeIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides instructions for bridging UI/UX design briefs into Pencil design workflows. It focuses on safe document handling and credential protection, with no evidence of malicious behavior, data exfiltration, or remote code execution. Standard validation scripts for local use are documented.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Pencil Design Bridge
This skill is the Pencil layer in the UI/UX Agent Skill System. Pencil is a design-tool bridge and editable design workspace, not the central architect and not a plain-file parser.
Operating Modes
brief: turn an approved direction brief into a Pencil-ready design brief.canvas-handoff: prepare instructions for Pencil MCP/tools or a Pencil-capable agent.review-output: review Pencil output against UX, SEO/LLM, accessibility, brand, and implementation constraints.figma-code-handoff: prepare Pencil results for Figma or code implementation.config-check: check whether Pencil tools are available in the current runtime without reading.penfiles directly.
Required Workflow
- Read references/pencil-bridge-contract.md.
- Confirm the source brief was approved by
senior-ui-ux-orchestratoror came from an explicit user decision. - Confirm inputs:
- product/UX journey;
- SEO/LLM constraints for public pages;
ui-ux-pro-maxdesign intelligence;- optional Stitch output or Figma constraints;
- required assets and forbidden claims.
- Use assets/pencil-handoff.template.md for handoff packets.
- Access
.pendocuments only through Pencil MCP/tools. Do not use shell reads, grep, cat, or ad hoc JSON parsing on.penfiles. - Treat Pencil output as a candidate design artifact. It still needs review before Figma, code, or production use.
Safety Rules
- Do not store API keys, tokens, cookies, private URLs, private screenshots, or
.envvalues in Pencil handoffs. - Do not claim a Pencil tool ran unless a callable Pencil tool was used and an artifact path or tool response exists.
- If Pencil tooling is unavailable, produce a manual handoff and mark execution as
SkippedorPlanned. - If Pencil output conflicts with accessibility, visible facts, SEO/LLM structure, or implementation feasibility, route to council.
Handoff Shape
Mode:
Approved direction:
Pencil tool availability:
Input artifacts:
Data excluded:
Prompt or canvas instructions:
Design-system constraints:
Review criteria:
Next owner:
Checks:
Validation
When editing this skill, run:
python3 $CODEX_HOME/skills/.system/skill-creator/scripts/quick_validate.py $CODEX_HOME/skills/pencil-design-bridge
python3 $CODEX_HOME/skills/senior-skill-architect/scripts/lint_production_skill.py $CODEX_HOME/skills/pencil-design-bridge
python3 -m json.tool $CODEX_HOME/skills/pencil-design-bridge/evals/evals.json >/dev/null
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/sergekostenchuk/ui-ux-agent-skill-system/pencil-design-bridge">View pencil-design-bridge on skillZs</a>