SuperAPI AI Directory

pencil-design-bridge

Design & creation

View repository

Updated 10-16 02:41

About this skill

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 .pen files directly.

Required Workflow

  1. Read references/pencil-bridge-contract.md.
  2. Confirm the source brief was approved by senior-ui-ux-orchestrator or came from an explicit user decision.
  3. Confirm inputs:
    • product/UX journey;
    • SEO/LLM constraints for public pages;
    • ui-ux-pro-max design intelligence;
    • optional Stitch output or Figma constraints;
    • required assets and forbidden claims.
  4. Use assets/pencil-handoff.template.md for handoff packets.
  5. Access .pen documents only through Pencil MCP/tools. Do not use shell reads, grep, cat, or ad hoc JSON parsing on .pen files.
  6. 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 .env values 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 Skipped or Planned.
  • 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