Agent skill

Setup

by WellApp-ai in WellApp-ai/Well

One-time environment setup for new team members. An agent skill from WellApp-ai/Well.

MITAuto-check: notesDevOps & Cloud

Install Setup

skills CLI
$ npx skills add WellApp-ai/Well --skill setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install WellApp-ai/Well setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/WellApp-ai/Well.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cursor-rules/skills/setup .claude/skills/setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
setup
GitHub stars
345
Token cost
~1k tokens
SKILL.md length
406 words
Files
1
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

One-time environment setup for new team members. An agent skill from WellApp-ai/Well.

  • Works in 7 steps: Core Development Tools → Repository Setup → 5: Pattern Resources Orientation → …
  • DevOps & Cloud work in your project
  • SKILL.md covers Phase 1: Core Development Tools, Phase 2: Repository Setup, Phase 2.5: Pattern Resources… and Phase 3: Environment…, plus 4 more sections
  • Calls npm and docker-compose; reaches mcp.figma.com

What it does

Setup is an agent skill from WellApp-ai/Well. One-time environment setup for new team members

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in DevOps & Cloud. It works with Model Context Protocol, Docker, Figma and npm. The repository describes itself as: No more Sundays on Finance. We build the infrastructure that retrieves, processes, and routes your financial and business data to your FinOps stack, so founders can ship, not… The licence is MIT.

When your agent uses it

  • DevOps & Cloud work in your project

Example prompts

  • “/setup”

Requirements

  • Node.js
  • Docker
  • A credential in YOUR_NOTION_TOKEN
  • A credential in YOUR_N8N_TOKEN

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Core Development Tools
  2. Repository Setup
  3. 5: Pattern Resources Orientation
  4. Environment Configuration
  5. MCP Configuration
  6. Cursor Settings
  7. Verification

What it can do on your machine

Read from SKILL.md and the folder at commit c740217. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • docker-compose

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • mcp.figma.com

    Also links to:

    • figma.com
    • mobbin.com
    • pageflows.com
    • refactoringui.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Setup loads about 1k tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 406 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~13
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:42
    1. Copy `.env.example` to `.env` in:
  • NoteMentions a .env fileSKILL.md:43
    - `apps/api/.env`
  • NoteMentions a .env fileSKILL.md:44
    - `apps/web/.env`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from WellApp-ai/Well at commit c740217, republished under its MIT licence (© WellApp-ai). 406 words, ~1,020 tokens.

Download SKILL.mdSave it as .claude/skills/setup/SKILL.md (or your agent's skills folder).
name
setup
description
One-time environment setup for new team members

Environment Setup Skill

Use this skill for first-time setup of your development environment.

Phase 1: Core Development Tools

Verify these are installed:

  • Cursor IDE (latest version)
  • GitHub Desktop
  • Docker
  • TablePlus (database GUI)
  • Figma Desktop App - https://www.figma.com/downloads/
  • Screen.studio (optional, for demos)
  • Google Cloud SDK (only for admins)

Phase 2: Repository Setup

  1. Clone the repository
  2. Run npm install in monorepo root
  3. Start Docker: docker-compose up -d
  4. Run migrations: npm run migrate
  5. Seed database: npm run seed

Phase 2.5: Pattern Resources Orientation

Familiarize yourself with design resources:

  1. Read /docs/pattern-resources.md - External UI/UX references
  2. Read /docs/design-system/ folder - Internal tokens and guidelines
  3. Bookmark key competitor sites for your domain:

Phase 3: Environment Configuration

  1. Copy .env.example to .env in:
    • apps/api/.env
    • apps/web/.env
  2. Configure required variables

Phase 4: MCP Configuration

Cursor's UI auto-install can loop indefinitely. Edit ~/.cursor/mcp.json directly.

Complete mcp.json Template

Copy this to ~/.cursor/mcp.json and replace YOUR_* placeholders:

json
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_NOTION_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
      }
    },
    "n8n-mcp": {
      "command": "npx",
      "args": ["-y", "supergateway", "--streamableHttp", "YOUR_N8N_URL/mcp-server/http", "--header", "authorization:Bearer YOUR_N8N_TOKEN"]
    },
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "figma": {
      "url": "http://127.0.0.1:3845/mcp"
    }
  }
}
Authentication by MCP
MCPAuth TypeHow to Get Token
NotionAPI Tokennotion.so/my-integrations > New integration > Copy token
n8nBearer Tokenn8n instance > Settings > API > Create key
Context7NoneJust works
Figma DesktopNoneEnable in Figma app Dev Mode (Shift+D)
Figma RemoteOAuthUse "url": "https://mcp.figma.com/mcp", click Connect in Cursor
BrowserNoneBuilt-in to Cursor
Show full SKILL.md (181 more words)Show less
Browser MCP (Built-in)

Browser MCP is built into Cursor and requires no setup. Use it for:

  • Taking screenshots of competitor apps during DIVERGE phase
  • Testing Storybook stories
  • E2E workflow verification

Tip: During feature exploration, navigate to competitor apps and use browser_take_screenshot to capture reference designs.

Troubleshooting

MCP won't install (infinite loop):

  1. Cancel the operation (Cmd+C or close dialog)
  2. Manually edit ~/.cursor/mcp.json
  3. Add the config block directly
  4. Restart Cursor: Cmd+Shift+P > "Reload Window"

MCP shows disconnected:

  1. Verify JSON syntax is valid (use jsonlint.com)
  2. Check token is correct and not expired
  3. For Figma: ensure desktop app is running with MCP enabled

Verification: After restart, list MCP folder to confirm all servers loaded:

bash
ls ~/.cursor/projects/*/mcps/

Phase 5: Cursor Settings

Configure in Cursor Settings:

  • Model: Claude Opus 4.5
  • Auto mode: Disabled
  • Completion sounds: Enabled
  • Usage summary: Always

Phase 6: Verification

Run these to verify setup:

  • npm run dev - starts without errors
  • npm run typecheck - passes
  • npm run storybook - loads components

Completion

When all phases complete, you're ready to use:

  • init [Notion URL] - Start a new feature
  • plan [feature] - Create implementation plan

© WellApp-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in cursor-rules/skills/setup of WellApp-ai/Well.

Open the folder on GitHubat commit c740217

Compare with similar skills

Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Setup this skillWellApp-ai/Well345—~1kAutomated safety check: NotesMIT
Manage Artifactsharness/harness-skills115—~1.4kAutomated safety check: PassApache-2.0
Frontend Build Timing Auditopenops-cloud/openops1.1k—~2.3kAutomated safety check: PassCustom licence
Figma Typings Auditawdr74100/figwright977—~3.3kAutomated safety check: PassMIT
Oneclickvirtoneclickvirt/oneclickvirt372—~1.1kAutomated safety check: PassGPL-3.0
Project Releaseswimmwatch/cloakbrowser-mcp161—~1.9kAutomated safety check: PassMIT

Similar skills

  • Manage Artifacts

    harness/harness-skills

    Manage Harness Artifact Registry (AR) via MCP. An agent skill from harness/harness-skills.

    115 GitHub stars~1.4k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Frontend Build Timing Audit

    openops-cloud/openops

    Detects and diagnoses chunk-evaluation timing bugs in the Vite/rolldown production build of react-ui (works-in-dev / broken-in-build i18n regressions, missing UI labels, module-scope t()…

    1.1k GitHub stars~2.3k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Figma Typings Audit

    awdr74100/figwright

    Upgrade @figma/plugin-typings and absorb what the new version exposes.

    977 GitHub stars~3.3k tokensUpdated today
    DevelopmentAuto-check passed
  • Oneclickvirt

    oneclickvirt/oneclickvirt

    OneClickVirt operations skill for managing containers, virtual machines, provider nodes, health checks, and metrics through MCP.

    372 GitHub stars~1.1k tokensUpdated 5 days ago
    DevOps & CloudAuto-check passed
  • Project Release

    swimmwatch/cloakbrowser-mcp

    Prepare, publish, verify, or recover a cloakbrowser-mcp release only when the user explicitly requests release work.

    161 GitHub stars~1.9k tokensUpdated 6 days ago
    Agent WorkflowsAuto-check passed
  • Devcontainer Dev

    stacklok/toolhive-studio

    Spin up and interact with ToolHive Studio's containerized dev environment (Xvfb + noVNC + DinD).

    170 GitHub stars~3.8k tokensUpdated today
    Agent WorkflowsAuto-check: notes

More from WellApp-ai/Well

All 36 skills in this repo
  • Tech Divergence

    WellApp-ai/Well

    Evaluate technical options with scoring matrix, trigger Gate 4 for significant decisions

    345 GitHub stars~1.3k tokensUpdated 7 days ago
    Auto-check passed
  • Ar Aging

    WellApp-ai/Well

    Produce an accounts-receivable aging report and surface overdue invoices for a Well workspace.

    345 GitHub stars~532 tokensUpdated 7 days ago
    Auto-check passed
  • Autonomous Loop

    WellApp-ai/Well

    Iterate until success or limit, composing existing skills with Jidoka integration

    345 GitHub stars~1k tokensUpdated 7 days ago
    Auto-check passed
  • Balance Sheet

    WellApp-ai/Well

    Build a balance sheet (bilan) from a Well workspace. An agent skill from WellApp-ai/Well.

    345 GitHub stars~534 tokensUpdated 7 days ago
    Auto-check passed
  • Bpmn Workflow

    WellApp-ai/Well

    Generate and maintain BPMN 2.0 diagrams linked to Gherkin scenarios

    345 GitHub stars~1.4k tokensUpdated 7 days ago
    Auto-check passed
  • Cash Flow Forecast

    WellApp-ai/Well

    Forecast cash flow and runway for a Well workspace from booked invoices and collected bank transactions.

    345 GitHub stars~567 tokensUpdated 7 days ago
    Auto-check passed

Questions about Setup

What does Setup do?

One-time environment setup for new team members. An agent skill from WellApp-ai/Well. Setup is an agent skill from WellApp-ai/Well.

When should I use Setup?

Setup fits situations like: devOps & Cloud work in your project.

How do I install Setup in Claude Code?

Run `npx skills add WellApp-ai/Well --skill setup -a claude-code`. Or copy the skill folder (cursor-rules/skills/setup in WellApp-ai/Well) into .claude/skills/setup in your project. Claude Code loads it when a task matches its description.

How do I install Setup in Codex?

Run `npx skills add WellApp-ai/Well --skill setup -a codex`. Or copy the skill folder (cursor-rules/skills/setup in WellApp-ai/Well) into .agents/skills/setup in your project. Codex loads it when a task matches its description.

Can I use Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add WellApp-ai/Well --skill setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/setup, .gemini/skills/setup, .github/skills/setup and .opencode/skills/setup in your project.

What does Setup need to run?

Going by SKILL.md and its folder, Setup needs the command-line tools its instructions call (npm and docker-compose). Our summary lists: Node.js; Docker; A credential in YOUR_NOTION_TOKEN; A credential in YOUR_N8N_TOKEN.

Does Setup access the network?

SKILL.md names 5 domains. In commands or code: mcp.figma.com; the agent is likely to contact it when it follows the instructions. As links in the text: figma.com, mobbin.com, pageflows.com and refactoringui.com. This is read from the text; nothing was executed.

Is Setup safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Setup use?

Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Setup use?

About 1k tokens (SKILL.md is roughly 4.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Setup?

Skills that share tags, products or a category with Setup: Manage Artifacts (harness/harness-skills, 115 stars), Frontend Build Timing Audit (openops-cloud/openops, 1.1k stars), Figma Typings Audit (awdr74100/figwright, 977 stars) and Oneclickvirt (oneclickvirt/oneclickvirt, 372 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Setup?

WellApp-ai (a GitHub organization) maintains it in WellApp-ai/Well, which has 345 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on September 30, 2026.

Source: WellApp-ai/Well on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.