pencil-ui-design-system-bootstrap

Bootstrap Design System Initializer

Constraint: Only use this skill when the user explicitly mentions "Pencil" and "Bootstrap" or when orchestrating a Pencil design system initialization task.

When to use this skill

Use this skill when:

• The user wants to initialize Bootstrap tokens (primary, secondary, danger, warning colors) in a Pencil .pen file
• The user needs a component overview frame for Bootstrap components in Pencil
• The user mentions "Pencil" together with "Bootstrap" or Bootstrap-specific components (Card, Modal, Navbar, Grid)
• An orchestrator skill (pencil-ui-designer) routes a Bootstrap initialization request

How to use this skill

This skill outputs a PENCIL_PLAN. The Agent then calls Pencil MCP tools in order: open_document, set_variables, batch_design, optionally get_screenshot.

Step 1: Initialize Variables (set_variables)

Use mcp__pencil__set_variables to register Bootstrap design tokens. Follow .pen file schema.

Primary / Semantic

• bs-primary: #0d6efd
• bs-secondary: #6c757d
• bs-success: #198754
• bs-danger: #dc3545
• bs-warning: #ffc107
• bs-info: #0dcaf0
• bs-light: #f8f9fa
• bs-dark: #212529

Body & Border

• bs-body-color: #212529
• bs-border-color: #dee2e6
• bs-border-radius: 0.375rem (6px)

Font

• bs-font-size-base: 1rem (16px)

Fill from Bootstrap Sass variables / CSS variables if more tokens are needed.

Step 2: Create Component Overview Structure (batch_design)

Use mcp__pencil__batch_design to create a "Components Overview" frame with sections based on Bootstrap documentation:

1. Layout
   • Container, Grid, Stack
2. Content
   • Typography, Images, Tables
3. Forms
   • Form, Input, Select, Checkbox, Radio, Switch, Range
4. Components
   • Accordion, Alert, Badge, Breadcrumb, Buttons, Button group, Card, Carousel, Close button, Collapse, Dropdowns, List group, Modal, Navbar, Offcanvas, Pagination, Placeholders, Popovers, Progress, Scrollspy, Spinners, Toasts, Tooltips
5. Utilities
   • Borders, Colors, Display, Flex, Float, Spacing

Organize frames using Auto Layout. Keep each batch_design call to maximum 25 operations.

Example: Initialize Bootstrap Variables

{
  "name": "set_variables",
  "arguments": {
    "filePath": "designs/app.pen",
    "replace": false,
    "variables": {
      "bs-primary": "#0d6efd",
      "bs-secondary": "#6c757d",
      "bs-success": "#198754",
      "bs-danger": "#dc3545",
      "bs-warning": "#ffc107",
      "bs-body-color": "#212529",
      "bs-border-color": "#dee2e6",
      "bs-border-radius": "6px"
    }
  }
}

Best Practices

• Verify token values against Bootstrap docs (Sass/CSS variables).
• Use set_variables with replace: false unless a full reset is requested.
• Use Auto Layout for component overview frames.
• Keep each batch_design call to maximum 25 operations; split by category if needed.

Keywords

pencil, bootstrap, design system, init, variables, components

References

• references/contract.md – Design tokens and component naming.
• references/official.md – Link to official documentation.
• references/examples.md – Example PENCIL_PLAN.
• references/components.md – Component specifications.