Agent skill

Onboarding

by grandamenium in grandamenium/cortextos

MITAuto-check: notesProductivity & Automation

Install Onboarding

skills CLI

$ npx skills add grandamenium/cortextos --skill onboarding -a claude-code

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

GitHub CLI

$ gh skill install grandamenium/cortextos onboarding --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/grandamenium/cortextos.git skills-src && mkdir -p .claude/skills && cp -r skills-src/community/skills/onboarding .claude/skills/onboarding && 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 "onboarding" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/onboarding into .claude/skills/onboarding/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboarding", 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/grandamenium/cortextos/tree/main/community/skills/onboarding

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 grandamenium/cortextos --skill onboarding -a codex

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

GitHub CLI

$ gh skill install grandamenium/cortextos onboarding --agent codex

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

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .agents/skills && cp -r skills-src/community/skills/onboarding .agents/skills/onboarding && 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 "onboarding" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/onboarding into .agents/skills/onboarding/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboarding", 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 grandamenium/cortextos --skill onboarding -a cursor

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

GitHub CLI

$ gh skill install grandamenium/cortextos onboarding --agent cursor

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

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/community/skills/onboarding .cursor/skills/onboarding && 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 "onboarding" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/onboarding into .cursor/skills/onboarding/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboarding", 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/grandamenium/cortextos.git --path community/skills/onboarding

--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 grandamenium/cortextos --skill onboarding -a gemini-cli

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

GitHub CLI

$ gh skill install grandamenium/cortextos onboarding --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/grandamenium/cortextos.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/community/skills/onboarding .gemini/skills/onboarding && 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 "onboarding" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/onboarding into .gemini/skills/onboarding/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboarding", 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 grandamenium/cortextos onboarding

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 grandamenium/cortextos --skill onboarding -a github-copilot

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

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .github/skills && cp -r skills-src/community/skills/onboarding .github/skills/onboarding && 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 "onboarding" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/onboarding into .github/skills/onboarding/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboarding", 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 grandamenium/cortextos --skill onboarding -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 grandamenium/cortextos onboarding --agent opencode

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

Manual copy

$ git clone --depth 1 https://github.com/grandamenium/cortextos.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/community/skills/onboarding .opencode/skills/onboarding && 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 "onboarding" agent skill from https://github.com/grandamenium/cortextos/tree/main/community/skills/onboarding into .opencode/skills/onboarding/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "onboarding", 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: onboarding
GitHub stars: 101
Token cost: ~1.2k tokens
SKILL.md length: 445 words
Files: 1
Skills in repo: 55
Repo updated: Sep 23, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Works in 5 steps: Detect your runtime → Check onboarding status → Read ONBOARDING.md → …
Tasks that involve Chatbots and conversational support
SKILL.md covers Step 0: Detect your runtime, Step 1: Check onboarding status, Step 2: Read ONBOARDING.md and Step 3: What onboarding…, plus 4 more sections
Needs CLAUDE_CODE_OAUTH_TOKEN and CODEX_API_KEY

What it does

Onboarding is an agent skill from grandamenium/cortextos. You have just booted for the first time — there is no .onboarded flag in your state directory — and you need to set up your identity, connect your Telegram bot, configure your goals, and establish yourself within the org. Or onboarding was previously interrupted and the user has asked you to run it again. This skill walks you through every step of becoming a functioning agent. Do not skip steps. Do not start normal operations until onboarding is complete.

Its SKILL.md is about 1.2k 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 Productivity & Automation, covering Chatbots and conversational support and Scheduled and recurring tasks. It works with Telegram. The licence is MIT.

When your agent uses it

Tasks that involve Chatbots and conversational support
Tasks that involve Scheduled and recurring tasks

Example prompts

“/onboarding”

Requirements

A credential in CLAUDE_CODE_OAUTH_TOKEN
A credential in CODEX_API_KEY

Workflow steps

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

Detect your runtime
Check onboarding status
Read ONBOARDING.md
What onboarding establishes
Mark complete

What it can do on your machine

Read from SKILL.md and the folder at commit 6f93838. 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
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- CLAUDE_CODE_OAUTH_TOKEN
- CODEX_API_KEY
- BOT_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Onboarding loads about 1.2k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 445 words of instructions outside code blocks.

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

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:66

| Telegram bot connected and tested | `.env` (BOT_TOKEN, CHAT_ID) |

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 grandamenium/cortextos at commit 6f93838, republished under its MIT licence (© grandamenium). 445 words, ~1,206 tokens.

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

name: onboarding
description: You have just booted for the first time — there is no .onboarded flag in your state directory — and you need to set up your identity, connect your Telegram bot, configure your goals, and establish yourself within the org. Or onboarding was previously interrupted and the user has asked you to run it again. This skill walks you through every step of becoming a functioning agent. Do not skip steps. Do not start normal operations until onboarding is complete.
triggers: onboarding, /onboarding, first boot, run onboarding, setup, not onboarded, configure agent, set up identity, establish identity, set goals, onboard me, start…

Onboarding

This skill runs on first boot or when explicitly triggered. It is the only thing you should do until it is complete.

Step 0: Detect your runtime

Read config.json to find your runtime — it determines where your skills live, which slash-commands exist, and which env vars matter.

bash

RUNTIME=$(grep -o '"runtime"[[:space:]]*:[[:space:]]*"[^"]*"' config.json | sed -E 's/.*"runtime"[[:space:]]*:[[:space:]]*"([^"]*)".*/\1/')
echo "Runtime: ${RUNTIME:-claude-code}"

Branch the rest of onboarding on this value:

Runtime	Skills location	Slash-commands available	Auth env var
`claude-code` (default)	`.claude/skills/<skill>/SKILL.md`	`/loop`, `/usage`, `/compact`, etc.	`CLAUDE_CODE_OAUTH_TOKEN`
`codex-app-server`	`plugins/cortextos-agent-skills/skills/<skill>/SKILL.md` (linked into `~/.codex/skills/<agent>__<skill>`)	none — codex has no slash-command surface	`CODEX_API_KEY` (or codex login)
`hermes`	hermes-specific (see hermes adapter docs)	none	hermes-specific

If runtime is missing or empty, treat it as claude-code (legacy default).

Step 1: Check onboarding status

bash

[[ -f "${CTX_ROOT}/state/${CTX_AGENT_NAME}/.onboarded" ]] && echo "ONBOARDED" || echo "NEEDS_ONBOARDING"

If already ONBOARDED, skip to normal session start. Do not re-run onboarding unless the user explicitly requests it.

Step 2: Read ONBOARDING.md

bash

cat ONBOARDING.md

This file contains the full onboarding protocol for your specific agent role. Follow every step exactly. Do not improvise.

Step 3: What onboarding establishes

Onboarding must complete all of the following before you are considered functional:

Item	File written
Your name, role, emoji, and identity	`IDENTITY.md`
Your behavior, autonomy rules, and mode	`SOUL.md`
Your current goals and focus	`GOALS.md`
User preferences and context	`USER.md`
Guardrails and patterns to avoid	`GUARDRAILS.md`
Telegram bot connected and tested	`.env` (BOT_TOKEN, CHAT_ID)
Crons configured and running	`config.json`
.onboarded flag written	`$CTX_ROOT/state/$CTX_AGENT_NAME/.onboarded`

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

Step 3b: External Persistent Crons

Your crons survive restarts automatically. No manual restoration needed.

When you set up recurring workflows during onboarding, add them as persistent crons:

bash

# Example: heartbeat every 6h
cortextos bus add-cron $CTX_AGENT_NAME heartbeat 6h Read HEARTBEAT.md and follow its instructions.

The daemon reads ${CTX_ROOT}/state/${CTX_AGENT_NAME}/crons.json on every start and re-schedules all entries. Your crons will fire even after crashes or hard restarts.

Use cortextos bus add-cron for any workflow that must keep running across restarts. (Claude-Code-runtime agents: do NOT use /loop for persistent scheduling — it is session-only and dies on restart. Codex-runtime agents have no /loop to begin with; add-cron is the only path.)

For full details, see the ## External Persistent Crons section in AGENTS.md.

Step 4: Mark complete

When all steps in ONBOARDING.md are done:

bash

mkdir -p "$CTX_ROOT/state/$CTX_AGENT_NAME"
touch "$CTX_ROOT/state/$CTX_AGENT_NAME/.onboarded"

Then notify the user via Telegram that you are online and ready.

If Onboarding Is Interrupted

If a session crash or restart interrupts onboarding mid-way:

Check which steps completed (look at which files exist)
Resume from the first incomplete step
Do NOT restart from the beginning if some steps already completed
Re-run /onboarding if needed to trigger this skill again

Critical Rules

Do NOT send a Telegram message claiming you are online until onboarding is complete
Do NOT set up crons until IDENTITY.md and GOALS.md are written
Do NOT start processing user requests until .onboarded is written
The user is waiting — be efficient, but do not skip steps

Files

Just SKILL.md in community/skills/onboarding of grandamenium/cortextos.

Open the folder on GitHubat commit 6f93838

Compare with similar skills

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

Onboarding compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Onboarding this skillgrandamenium/cortextos	101	—	~1.2k	Automated safety check: Notes	MIT	18 days ago
Actionizeinfranodus/skills	119	—	~3.8k	Automated safety check: Notes	None	20 days ago
Telegram Bot Messagingsickn33/agentic-awesome-skills	47k	1 repos	~1.1k	Automated safety check: Pass	Apache-2.0	2 days ago
Team BuilderLeoYeAI/openclaw-master-skills	2.2k	—	~5.7k	Automated safety check: Pass	MIT	2 mo ago
Pytdbotpytdbot/client	137	—	~4.3k	Automated safety check: Pass	MIT	today
Setupterranc/claude-telegram-bot-bridge	134	—	~1.5k	Automated safety check: Notes	None	4 mo ago

Similar skills

Actionize
infranodus/skills
Turn insights, findings, or research into an actionable plan with deadlines and scheduled Telegram reminders.
119 GitHub stars~3.8k tokensUpdated 20 days ago
Productivity & AutomationAuto-check: notes
Telegram Bot Messaging
sickn33/agentic-awesome-skills
Send Telegram messages, files, and alerts via bot API; ask questions with inline buttons and wait for the answer.
47k GitHub starsUsed in 1 repo~1.1k tokens
Productivity & AutomationAuto-check passed
Team Builder
LeoYeAI/openclaw-master-skills
Deploy a multi-agent SaaS growth team on OpenClaw with shared workspace, async inbox communication, cron-scheduled tasks, deep project code scanning (Deep Dive), and optional Telegram integration.
2.2k GitHub stars~5.7k tokensUpdated 2 mo ago
Productivity & AutomationAuto-check passed
Pytdbot
pytdbot/client
Write Telegram bots and userbots with Pytdbot (async TDLib wrapper with high-level helpers; not the Telegram Bot API).
137 GitHub stars~4.3k tokensUpdated today
Productivity & AutomationAuto-check passed
Setup
terranc/claude-telegram-bot-bridge
Install and configure the Telegram Skill Bot. An agent skill from terranc/claude-telegram-bot-bridge.
134 GitHub stars~1.5k tokensUpdated 4 mo ago
Productivity & AutomationAuto-check: notes
Muse
KevPH2026/muse-catch
Muse · Catch — AI灵感捕手。浏览器插件+Telegram Bot一键捕获，AI自动提炼，Dashboard浏览+DNA雷达+OPC Market。当用户说「灵感」「捕获」「Muse」「Catch」「记下来」「收藏」时触发。
128 GitHub stars~865 tokensUpdated 1 mo ago
Productivity & AutomationAuto-check passed

More from grandamenium/cortextos

All 55 skills in this repo

Cortext Self Diagnosis
grandamenium/cortextos
Diagnose cortextOS itself when the framework misbehaves — an agent has gone silent or wedged, agents are crash-looping, Telegram or agent-to-agent messages are not arriving, crons did not fire, an…
101 GitHub stars~3.7k tokensUpdated 18 days ago
Auto-check passed
Activity Channel
grandamenium/cortextos
You have completed something significant and want the whole org — all agents and the user — to know about it.
101 GitHub stars~624 tokensUpdated 18 days ago
Auto-check passed
Agentcard Purchase
grandamenium/cortextos
You need to make a purchase on behalf of the user — buy a SaaS subscription, pay for an API, purchase a domain, or any transaction requiring a credit card.
101 GitHub stars~1.1k tokensUpdated 18 days ago
Auto-check passed
Claude To Codex Migration
grandamenium/cortextos
Migrate ANY cortextOS agent from the claude-code runtime to the live codex-app-server runtime.
101 GitHub stars~12k tokensUpdated 18 days ago
Auto-check: warnings
Bus Reference
grandamenium/cortextos
Complete cortextos bus CLI reference - all available commands with examples.
101 GitHub stars~3.8k tokensUpdated 18 days ago
Auto-check passed
Business News Monitor
grandamenium/cortextos
Daily cron-driven scan of news/forums/social in a domain to surface market shifts, new competitors, regulatory changes, and net-new opportunities.
101 GitHub stars~1.3k tokensUpdated 18 days ago
Auto-check passed

Works with

Questions about Onboarding

What does Onboarding do?

You have just booted for the first time — there is no .onboarded flag in your state directory — and you need to set up your identity, connect your Telegram bot, configure your goals, and establish…. Onboarding is an agent skill from grandamenium/cortextos.onboarded flag in your state directory — and you need to set up your identity, connect your Telegram bot, configure your goals, and establish yourself within the org.

When should I use Onboarding?

Onboarding fits situations like: tasks that involve Chatbots and conversational support; tasks that involve Scheduled and recurring tasks.

How do I install Onboarding in Claude Code?

Run `npx skills add grandamenium/cortextos --skill onboarding -a claude-code`. Or copy the skill folder (community/skills/onboarding in grandamenium/cortextos) into .claude/skills/onboarding in your project. Claude Code loads it when a task matches its description.

How do I install Onboarding in Codex?

Run `npx skills add grandamenium/cortextos --skill onboarding -a codex`. Or copy the skill folder (community/skills/onboarding in grandamenium/cortextos) into .agents/skills/onboarding in your project. Codex loads it when a task matches its description.

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

What does Onboarding need to run?

Going by SKILL.md and its folder, Onboarding needs credentials named CLAUDE_CODE_OAUTH_TOKEN, CODEX_API_KEY and BOT_TOKEN. Our summary lists: A credential in CLAUDE_CODE_OAUTH_TOKEN; A credential in CODEX_API_KEY.

Does Onboarding access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Onboarding 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 Onboarding use?

Onboarding 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 Onboarding use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 Onboarding?

Skills that share tags, products or a category with Onboarding: Actionize (infranodus/skills, 119 stars), Telegram Bot Messaging (sickn33/agentic-awesome-skills, 47k stars), Team Builder (LeoYeAI/openclaw-master-skills, 2.2k stars) and Pytdbot (pytdbot/client, 137 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Onboarding?

grandamenium (a GitHub user) maintains it in grandamenium/cortextos, which has 101 GitHub stars. The repository holds 55 skills in this directory. The repository was last updated on September 23, 2026.

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

Install Onboarding

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

Onboarding

Step 0: Detect your runtime

Step 1: Check onboarding status

Step 2: Read ONBOARDING.md

Step 3: What onboarding establishes

Step 3b: External Persistent Crons

Step 4: Mark complete

If Onboarding Is Interrupted

Critical Rules

Files

Compare with similar skills

Similar skills

More from grandamenium/cortextos

Related

Questions about Onboarding