Agent skill

Onboard

Sets up ai-toolkit in a project: symlinks, CLAUDE.md, intent interview.

Apache-2.0Auto-check: notesAgent Workflows

Install Onboard

skills CLI

$ npx skills add softspark/ai-toolkit --skill onboard -a claude-code

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

GitHub CLI

$ gh skill install softspark/ai-toolkit onboard --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/softspark/ai-toolkit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/app/skills/onboard .claude/skills/onboard && 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/

Paste into Claude Code

Install the "onboard" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard into .claude/skills/onboard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboard", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add softspark/ai-toolkit --skill onboard -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit onboard --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .agents/skills && cp -r skills-src/app/skills/onboard .agents/skills/onboard && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "onboard" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard into .agents/skills/onboard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboard", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softspark/ai-toolkit --skill onboard -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit onboard --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/app/skills/onboard .cursor/skills/onboard && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "onboard" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard into .cursor/skills/onboard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboard", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/softspark/ai-toolkit.git --path app/skills/onboard

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add softspark/ai-toolkit --skill onboard -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit onboard --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/app/skills/onboard .gemini/skills/onboard && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "onboard" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard into .gemini/skills/onboard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboard", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install softspark/ai-toolkit onboard

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add softspark/ai-toolkit --skill onboard -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .github/skills && cp -r skills-src/app/skills/onboard .github/skills/onboard && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "onboard" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard into .github/skills/onboard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboard", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add softspark/ai-toolkit --skill onboard -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install softspark/ai-toolkit onboard --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/softspark/ai-toolkit.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/app/skills/onboard .opencode/skills/onboard && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "onboard" agent skill from https://github.com/softspark/ai-toolkit/tree/main/app/skills/onboard into .opencode/skills/onboard/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboard", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: onboard
GitHub stars: 179
Token cost: ~1.1k tokens
SKILL.md length: 485 words
Files: 1
Skills in repo: 112
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: Apache-2.0

At a glance

Sets up ai-toolkit in a project: symlinks, CLAUDE.md, intent interview.

Works in 7 steps: Intent Capture Interview → Prerequisites Check → Install Toolkit → …
Tasks that involve Agent instruction files
SKILL.md covers What This Command Does, Setup Steps, Usage Examples and Rules, plus 2 more sections
Calls git

What it does

Onboard is an agent skill from softspark/ai-toolkit. Sets up ai-toolkit in a project: symlinks, CLAUDE.md, intent interview. Triggers: onboard, setup project, install ai-toolkit, migrate project.

Its SKILL.md is about 1.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 Agent Workflows, covering Agent instruction files. The repository describes itself as: Professional-grade AI coding toolkit: 94 skills, 44 agents, multi-platform (Claude, Cursor, Windsurf, Copilot, Gemini, Cline, Roo Code, Aider, Augment, Antigravity, Codex CLI… The licence is Apache-2.0.

When your agent uses it

Tasks that involve Agent instruction files

Example prompts

“/onboard”

Requirements

Pre-approved tools (allowed-tools): Bash, Read, Write, Glob

Workflow steps

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

Intent Capture Interview
Prerequisites Check
Install Toolkit
Configure CLAUDE.md
Configure Settings
Verify Installation
Quick Start Guide

What it can do on your machine

Read from SKILL.md and the folder at commit d64db2b. 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
- Read
- Write
- Glob
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- git
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.
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

Onboard loads about 1.1k tokens when it runs. Until then it costs about 38 tokens; SKILL.md has 485 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~38
When it runs · the whole SKILL.md, loaded when a task matches: ~1.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.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Bash, Read, Write, Glob
```

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 softspark/ai-toolkit at commit d64db2b, republished under its Apache-2.0 licence (© softspark). 485 words, ~1,125 tokens.

Download SKILL.mdSave it as .claude/skills/onboard/SKILL.md (or your agent's skills folder).

name: onboard
description: Sets up ai-toolkit in a project: symlinks, CLAUDE.md, intent interview. Triggers: onboard, setup project, install ai-toolkit, migrate project.
allowed-tools: Bash, Read, Write, Glob
effort: medium
disable-model-invocation: true
argument-hint: [project-path]

/onboard - Project Setup Guide

$ARGUMENTS

What This Command Does

Guide the user through setting up the ai-toolkit in their project, including configuration and customization.

Setup Steps

Step 0: Intent Capture Interview

Before setting up tooling, understand the project's undocumented context. Ask the developer these questions (adapt based on what the codebase scan reveals):

What's the one thing a new contributor always gets wrong? — This reveals the biggest documentation gap
Are there files or directories that should NOT be modified? — Identifies protected areas (legacy, generated, vendor)
What's the deployment model? — Monolith, microservices, serverless, edge — shapes which agents and skills are most relevant
Are there non-obvious constraints? — Compliance requirements, performance budgets, browser support matrix
What's the team's review culture? — Strict PR reviews, trunk-based, pair programming — configures /review behavior

Use answers to:

Customize the generated CLAUDE.md with project-specific warnings and conventions
Select the right --profile (minimal/standard/strict) automatically
Pre-configure relevant language rules

Step 1: Prerequisites Check

Claude Code CLI installed
ai-toolkit repository cloned
Current directory is the target project

Step 2: Install Toolkit

bash

# Run the installer from the toolkit directory
/path/to/ai-toolkit/install.sh

This creates symlinks in .claude/:

agents/ -> toolkit agents
skills/ -> toolkit skills (slash commands + knowledge skills)
hooks.json -> quality gates
constitution.md -> safety rules

Step 3: Configure CLAUDE.md

Create a project-specific CLAUDE.md from the template:

bash

cp /path/to/ai-toolkit/CLAUDE.md.template ./CLAUDE.md

Customize with:

Project description and tech stack
Coding standards specific to this project
Common development commands
Architecture notes

Step 4: Configure Settings

Edit .claude/settings.local.json for project-specific settings:

MCP server connections
Permission overrides
Environment variables

Step 5: Verify Installation

bash

/path/to/ai-toolkit/validate.sh

Step 6: Quick Start Guide

Command	Purpose
`/explore`	Understand the codebase
`/plan`	Plan a new feature
`/test`	Run tests
`/review`	Code review
`/commit`	Create a structured commit

Usage Examples

/onboard              # Full guided setup
/onboard verify       # Just verify existing installation
/onboard update       # Update toolkit symlinks

Show full SKILL.md (212 more words)Show less

Rules

MUST run the intent-capture interview before creating any files — skip only if the user provides answers up front
NEVER overwrite an existing CLAUDE.md without confirming
CRITICAL: prefer project-local installation (--local) unless the user asks for global
MANDATORY: verify installation at the end with the toolkit's validate script

Gotchas

On Windows without WSL, symlink creation requires either Developer Mode or admin privileges. The installer silently skips agents and skills that cannot be linked — verify with ai-toolkit doctor after install on Windows hosts.
If .claude/ already exists as a real directory (not a symlink), ai-toolkit install will not replace it. Old files linger. Check ls -la .claude/ for mixed symlink + real-file state before onboarding.
settings.local.json is per-user and gitignored, but settings.json is shared. Users who edit the wrong file lose their overrides on git pull.
When the target project is a git submodule, the toolkit's notion of "project root" (outermost .git) differs from the developer's — symlinks may land in the parent repo instead of the submodule. Confirm git rev-parse --show-toplevel before installing.

When NOT to Use

To update an already-onboarded project — use /onboard update
To scaffold a new app from scratch — use /app-builder
For plugin development inside ai-toolkit — use /plugin-creator
When the project already has its own CLAUDE.md conventions — discuss migration before overwriting

Files

Just SKILL.md in app/skills/onboard of softspark/ai-toolkit.

Open the folder on GitHubat commit d64db2b

Compare with similar skills

Onboard 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.

Onboard compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Onboard this skillsoftspark/ai-toolkit	179	—	~1.1k	Automated safety check: Notes	Apache-2.0	yesterday
Using Agent Skillsaddyosmani/agent-skills	103k	4 repos	~2.4k	Automated safety check: Pass	MIT	4 days ago
Claude ReflectBayramAnnakov/claude-reflect	1.7k	2 repos	~627	Automated safety check: Pass	MIT	5 days ago
Writing For Agentsbestofjs/bestofjs	3.1k	19 repos	~2.7k	Automated safety check: Pass	MIT	3 days ago
Neat-Freak Knowledge CloseoutKKKKhazix/khazix-skills	21k	—	~1.9k	Automated safety check: Pass	MIT	7 days ago
Task Observerrebelytics/one-skill-to-rule-them-all	3.2k	1 repos	~12k	Automated safety check: Pass	CC-BY-4.0	6 days ago

Similar skills

Using Agent Skills
addyosmani/agent-skills
Meta-skill for choosing which workflow skill fits the task at hand, plus always-on habits: surface assumptions, stop on confusion, push back, keep it simple and stay in scope.
103k GitHub starsUsed in 4 repos~2.4k tokens
Agent WorkflowsAuto-check passed
Claude Reflect
BayramAnnakov/claude-reflect
Self-learning system that captures corrections during sessions and reminds users to run /reflect to update CLAUDE.md.
1.7k GitHub starsUsed in 2 repos~627 tokens
Agent WorkflowsAuto-check passed
Writing For Agents
bestofjs/bestofjs
Writing documents for agents. An agent skill from bestofjs/bestofjs.
3.1k GitHub starsUsed in 19 repos~2.7k tokens
Agent WorkflowsAuto-check passed
Neat-Freak Knowledge Closeout
KKKKhazix/khazix-skills
Brings project docs, agent rule files, authorized memory and leftover workspace files back in line with what the code and runtime actually do at the end of a work session.
21k GitHub stars~1.9k tokensUpdated 7 days ago
Agent WorkflowsAuto-check passed
Task Observer
rebelytics/one-skill-to-rule-them-all
Monitors task execution for skill improvement opportunities.
3.2k GitHub starsUsed in 1 repo~12k tokens
Agent WorkflowsAuto-check passed
SkillOpt Sleep Cycle
microsoft/SkillOpt
Official
Runs an on-demand or nightly sleep cycle that reviews past Claude Code sessions and proposes validated updates to CLAUDE.md and skills.
18k GitHub stars~2.3k tokensUpdated yesterday
Agent WorkflowsAuto-check passed

Questions about Onboard

What does Onboard do?

Sets up ai-toolkit in a project: symlinks, CLAUDE.md, intent interview. Onboard is an agent skill from softspark/ai-toolkit.md, intent interview.

When should I use Onboard?

Onboard fits situations like: tasks that involve Agent instruction files.

How do I install Onboard in Claude Code?

Run `npx skills add softspark/ai-toolkit --skill onboard -a claude-code`. Or copy the skill folder (app/skills/onboard in softspark/ai-toolkit) into .claude/skills/onboard in your project. Claude Code loads it when a task matches its description.

How do I install Onboard in Codex?

Run `npx skills add softspark/ai-toolkit --skill onboard -a codex`. Or copy the skill folder (app/skills/onboard in softspark/ai-toolkit) into .agents/skills/onboard in your project. Codex loads it when a task matches its description.

Can I use Onboard 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 softspark/ai-toolkit --skill onboard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/onboard, .gemini/skills/onboard, .github/skills/onboard and .opencode/skills/onboard in your project.

What does Onboard need to run?

Going by SKILL.md and its folder, Onboard needs the command-line tools its instructions call (git). Its frontmatter pre-approves these tools: Bash, Read, Write, Glob.

Does Onboard access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Onboard safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Onboard use?

Onboard is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Onboard use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Onboard?

Skills that share tags, products or a category with Onboard: Using Agent Skills (addyosmani/agent-skills, 103k stars), Claude Reflect (BayramAnnakov/claude-reflect, 1.7k stars), Writing For Agents (bestofjs/bestofjs, 3.1k stars) and Neat-Freak Knowledge Closeout (KKKKhazix/khazix-skills, 21k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Onboard?

softspark (a GitHub user) maintains it in softspark/ai-toolkit, which has 179 GitHub stars. The repository holds 112 skills in this directory. The repository was last updated on October 7, 2026.

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

Install Onboard

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

/onboard - Project Setup Guide

What This Command Does

Setup Steps

Step 0: Intent Capture Interview

Step 1: Prerequisites Check

Step 2: Install Toolkit

Step 3: Configure CLAUDE.md

Step 4: Configure Settings

Step 5: Verify Installation

Step 6: Quick Start Guide

Usage Examples

Rules

Gotchas

When NOT to Use

Files

Compare with similar skills

Similar skills

More from softspark/ai-toolkit

Related

Questions about Onboard