firstrun

Automate initial uSpec configuration across Cursor, Claude Code CLI, or Codex CLI.

Updated Mar 25, 2026

Search Tags:#automation #template #library #figma #setup #uspec

Ready to run

npx skills add https://github.com/PytaichukBohdan/figma_board_connection --skill firstrun-pytaichukbohdan

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: firstrun
Source: https://github.com/PytaichukBohdan/figma_board_connection/tree/main/.claude/skills/uspec-firstrun
Command: npx skills add https://github.com/PytaichukBohdan/figma_board_connection --skill firstrun-pytaichukbohdan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

First-time setup for uSpec can be time-consuming and error-prone. This skill guides users through selecting the MCP provider, choosing the target environment, syncing skills to the correct directory, extracting template component keys from the Figma library, and writing the configuration to uspecs.config.json.

Core Features & Use Cases

Guided, interactive setup to collect MCP provider and environment choices.
Automatic library linking, component key discovery, font family detection, and config persistence.
Works across Cursor, Claude Code CLI, and Codex CLI deployments to initialize and customize a uSpec workspace.

Quick Start

Run firstrun to begin the initial setup flow and configure your uSpec environment.

Frequently Asked Questions about firstrun

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I set up uSpec for the first time in Cursor or Claude Code CLI?▼

Automated uSpec setup is handled by running the firstrun command, which guides interactive prompts to select your MCP provider, choose your target environment, and generate a configured uspecs.config.json file.

What is the process for linking a Figma library to a uSpec workspace?▼

Linking a Figma library during uSpec configuration involves the setup skill automatically validating library access, extracting template component keys, detecting font families, and persisting the discovered data into the configuration file.

Does uSpec initial setup work with Codex CLI environments?▼

Yes, uSpec initial setup supports Codex CLI environments alongside Cursor and Claude Code CLI, automatically syncing skills to the correct directory and applying the generated configuration across these platforms.

Why does my uSpec configuration fail to detect template component keys?▼

Template component key detection during uSpec setup requires successful Figma library access validation; if access fails or the library lacks defined templates, the automated extraction process cannot populate the config file.

Can I configure MCP providers manually instead of using an automated uSpec setup?▼

While manual configuration is possible, automated uSpec setup standardizes the process by using interactive prompts to select MCP providers, link templates, and extract component keys, reducing setup errors and ensuring valid config persistence.