Setup

What it does

When your agent uses it

• First-time setup
• Broken environments
• Missing env vars
• The app wont start

Example prompts

• “/setup”

Requirements

• Node.js
• Docker
• A credential in NUXT_AUTH0_CLIENT_SECRET
• A credential in NUXT_JWT_SECRET
• Pre-approved tools (allowed-tools): Bash, AskUserQuestion

Workflow steps

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

1. 1Prerequisites
2. 2Install dependencies
3. 3Environment variables
4. 4Start the local database (optional)
5. 5Start the dev server

What it can do on your machine

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

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash
  • AskUserQuestion

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Shell commands in SKILL.md call:

  • docker
  • pnpm
  • node
  • bash
  • npm

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

• Network

  Links to these hosts (documentation or services it may open):

  • github.com
  • nodejs.org

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

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • NUXT_TINYBIRD_TOKEN
  • NUXT_AUTH0_CLIENT_SECRET
  • NUXT_JWT_SECRET
  • NUXT_INSIGHTS_DB_PASSWORD
  • POSTGRES_PASSWORD

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

Context cost

Setup loads about 1.9k tokens when it runs. Until then it costs about 69 tokens; SKILL.md has 703 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~69

When it runs · the whole SKILL.md, loaded when a task matches

~1.9k

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

• NoteMentions a .env fileSKILL.md:5

  .env file, optional local PostgreSQL database (for auth/collections/chat work),

• NoteMentions a .env fileSKILL.md:45

  Create `frontend/.env` and populate it with the values below. Ask a team member for the secret values — they are shared

• NoteMentions a .env fileSKILL.md:75

  ell the user to let you know when their `.env` is ready, then continue to Step 4.

• NoteMentions a .env fileSKILL.md:99

  ate `NUXT_INSIGHTS_DB_PORT` in `frontend/.env` to match.

• NoteMentions a .env fileSKILL.md:199

  ) and update `NUXT_INSIGHTS_DB_PORT` in `.env`               |

• NoteMentions a .env fileSKILL.md:202

  | Check Auth0 env vars in `frontend/.env`                                                           |

• NoteMentions a .env fileSKILL.md:203

  INYBIRD_TOKEN` is populated in `frontend/.env`                                       |

• NoteMentions a .env fileSKILL.md:204

  true` and CM DB credentials to `frontend/.env`                            |

• NotePre-approves every shell command (allowed-tools: Bash)SKILL.md

  allowed-tools: Bash, AskUserQuestion

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 linuxfoundation/insights at commit 3df53b5, republished under its MIT licence (© linuxfoundation). 703 words, ~1,886 tokens.

name

setup

description

Full development environment setup from scratch — prerequisites, dependencies, .env file, optional local PostgreSQL database (for auth/collections/chat work), and dev server. Use for first-time setup, broken environments, missing env vars, or when the app won't start.

allowed-tools

Bash, AskUserQuestion

node --version    # must be 20+
pnpm --version    # must be 9+
docker info       # Docker must be running

pnpm install --filter frontend

NUXT_INSIGHTS_DB_WRITE_HOST=localhost
NUXT_INSIGHTS_DB_READ_HOST=localhost
NUXT_INSIGHTS_DB_PORT=5450
NUXT_INSIGHTS_DB_USERNAME=postgres
NUXT_INSIGHTS_DB_PASSWORD=example
NUXT_INSIGHTS_DB_DATABASE=insights

NUXT_CM_DB_ENABLED=true

lsof -i :5450 | grep LISTEN

docker start insights-postgres

docker run -d \
  --name insights-postgres \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=example \
  -e POSTGRES_DB=insights \
  -p 5450:5432 \
  postgres:15-alpine \
  postgres -c wal_level=logical

until docker exec insights-postgres pg_isready -U postgres; do sleep 1; done

cd database && \
  PGHOST=host.docker.internal \
  PGPORT=5450 \
  PGDATABASE=insights \
  PGUSER=postgres \
  PGPASSWORD=example \
  bash migrate.sh

docker exec insights-postgres psql -U postgres -d insights -c "\dt"

lsof -nP -iTCP:3000 -sTCP:LISTEN

lsof -ti tcp:3000 | xargs kill        # graceful (SIGTERM)
lsof -ti tcp:3000 | xargs kill -9     # force, if the above doesn't clear it

cd frontend && pnpm dev

docker stop insights-postgres && docker rm insights-postgres

© linuxfoundation, 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 .claude/skills/setup of linuxfoundation/insights.

Open the folder on GitHubat commit 3df53b5