Agent skill

SDK

Custom licenceAuto-check passedTesting & QA

Install SDK

skills CLI

$ npx skills add kortix-ai/suna --skill sdk -a claude-code

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

GitHub CLI

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

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 kortix-ai/suna --skill sdk -a codex

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

GitHub CLI

$ gh skill install kortix-ai/suna sdk --agent codex

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

Manual copy

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

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

GitHub CLI

$ gh skill install kortix-ai/suna sdk --agent cursor

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

Manual copy

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

--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 kortix-ai/suna --skill sdk -a gemini-cli

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

GitHub CLI

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

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 kortix-ai/suna --skill sdk -a github-copilot

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

Manual copy

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

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

Manual copy

$ git clone --depth 1 https://github.com/kortix-ai/suna.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/sdk .opencode/skills/sdk && 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 "sdk" agent skill from https://github.com/kortix-ai/suna/tree/dev/.agents/skills/sdk into .opencode/skills/sdk/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sdk", 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: sdk
GitHub stars: 20k
Token cost: ~9.6k tokens
SKILL.md length: 5,089 words
Files: 1
Skills in repo: 19
Repo updated: Oct 9, 2026
First seen: Oct 7, 2026
Licence: Custom licence

At a glance

Works in 2 steps: The Kortix platform REST API… → The session runtime — the harness…
Tasks that involve Test-driven development
SKILL.md covers The mental model: what this…, This package is published.…, Exported names ARE the API.… and Versioning: never touch the…, plus 10 more sections
Calls pnpm, npm and bun; needs NODE_AUTH_TOKEN

What it does

SDK is an agent skill from kortix-ai/suna. The hard rules for editing @kortix/sdk (packages/sdk) — a PUBLISHED npm package with constraints no other package in this repo has: TDD is mandatory (failing test first, gates run and pasted every turn, explicit shippable YES/NO/NOT YET); exported names INCLUDING types are a public API contract and renaming one is a breaking change; the version field is inert and must never be hand-bumped; adding an export requires three synchronized edits; and a static import-graph tripwire enforces the framework-free core. Load…

Its SKILL.md is about 9.6k 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 Testing & QA, covering Test-driven development and API design. It works with npm. The repository describes itself as: The open-source AI Operating System.

When your agent uses it

Tasks that involve Test-driven development
Tasks that involve API design

Example prompts

“/sdk”

Requirements

Node.js

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

The Kortix platform REST API (backendUrl, e.g. http://localhost:8008/v1).
The session runtime — the harness (OpenCode or pi) running *inside a per-session cloud

What it can do on your machine

Read from SKILL.md and the folder at commit 0d853bd. 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:
- pnpm
- npm
- bun
- tsc
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md. Its commands use pnpm and npm, 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 these keys or tokens, usually read from environment variables:
- NODE_AUTH_TOKEN
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

SDK loads about 9.6k tokens when it runs. Until then it costs about 164 tokens; SKILL.md has 5,089 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 5,089 words (~9,624 tokens).

“Read the repo-root AGENTS.md first — it covers the monorepo (worktrees, the local stack, verification standard, release topology). This file covers only what is specific to this package, and the traps that have no analogue elsewhere in the repo.”

— opening of SKILL.md by kortix-ai, Custom licence

name: sdk

Outline of SKILL.md

@kortix/sdk
The mental model: what this SDK actually is
The layers, bottom to top
Recipe: adding a new capability, end to end
The invariants, in one place
This package is published. People install it.
Exported names ARE the API. Renaming one breaks every consumer.
What is safe, and what is not
If you must rename, alias — never replace
Name it right the first time
The guardrail that actually enforces this
Versioning: never touch the version field
The core law: the core is framework-free
The three tiers
The tripwire walks imports. It cannot see globals.
The browser-only tier is internal machinery
Adding or moving an export requires three synchronized edits
Dual entrypoint: src/ in the workspace, dist/ on npm
Workspace dependencies get pinned at publish
Streaming is the fragile part. Treat it as a first-class target.
Field notes: what actually keeps an SDK maintainable
Commands
Test-driven, always. No exceptions in this package.
The loop
Never end a turn without running the gates
When a test fails: keep going, but never touch the test
Then say whether it is shippable
Tests ship with the change
Examples are executable documentation
Where the real logic goes

Read the full SKILL.md on GitHub

Files

Just SKILL.md in .agents/skills/sdk of kortix-ai/suna.

Open the folder on GitHubat commit 0d853bd

Compare with similar skills

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

SDK compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
SDK this skillkortix-ai/suna	20k	—	~9.6k	Automated safety check: Pass	Custom licence	today
Devserithemage/serverless-openclaw	196	—	~714	Automated safety check: Notes	None	6 mo ago
TDDRafaelGB/Obsidian-ZettelFlow	174	—	~724	Automated safety check: Pass	MIT	yesterday
ImplementRafaelGB/Obsidian-ZettelFlow	174	—	~1.7k	Automated safety check: Pass	MIT	yesterday
Test Driven Developmentjohnku2011/boilerplates-with-ai-skills	240	—	~777	Automated safety check: Notes	MIT	1 mo ago
TasksRafaelGB/Obsidian-ZettelFlow	174	—	~573	Automated safety check: Pass	MIT	yesterday

Similar skills

Dev
serithemage/serverless-openclaw
Development workflow guide. An agent skill from serithemage/serverless-openclaw.
196 GitHub stars~714 tokensUpdated 6 mo ago
Testing & QAAuto-check: notes
TDD
RafaelGB/Obsidian-ZettelFlow
The test-driven development workflow for ZettelFlow — write a failing test first, run jest, use the Obsidian mock and the bare-specifier alias mappings, and know which code is unit-testable.
174 GitHub stars~724 tokensUpdated yesterday
Testing & QAAuto-check passed
Implement
RafaelGB/Obsidian-ZettelFlow
Stage 4 of the SDD pipeline — execute a ZettelFlow task checklist (in a GitHub issue comment) test-first (red → green → refactor), one commit per advance, keeping npm run verify green and CI green…
174 GitHub stars~1.7k tokensUpdated yesterday
Testing & QAAuto-check passed
Test Driven Development
johnku2011/boilerplates-with-ai-skills
A skill your agent uses when implementing a feature or fixing a bug — TDD, red-green-refactor, failing test first, then minimal code, then refactor.
240 GitHub stars~777 tokensUpdated 1 mo ago
Testing & QAAuto-check: notes
Tasks
RafaelGB/Obsidian-ZettelFlow
Stage 3 of the SDD pipeline — turn a ZettelFlow plan (in a GitHub issue comment) into an ordered TDD task checklist posted as a second issue comment.
174 GitHub stars~573 tokensUpdated yesterday
Testing & QAAuto-check passed
Design An API
testdouble/han
Designs the contract for an API change inside one codebase — a component's props, a function surface, URL or query parameters, an event payload, or a module boundary — through a discovery pass, an…
279 GitHub stars~7k tokensUpdated 8 days ago
DevelopmentAuto-check passed

Questions about SDK

What does SDK do?

The hard rules for editing @kortix/sdk (packages/sdk) — a PUBLISHED npm package with constraints no other package in this repo has: TDD is mandatory (failing test first, gates run and pasted every…. SDK is an agent skill from kortix-ai/suna. The hard rules for editing @kortix/sdk (packages/sdk) — a PUBLISHED npm package with constraints no other package in this repo has: TDD is mandatory (failing test first, gates run and pasted every turn, explicit shippable YES/NO/NOT YET); exported names INCLUDING types are a public API contract and renaming one is a breaking change; the version field is inert and must never be hand-bumped; adding an export requires three synchronized edits; and a static import-graph tripwire enforces the framework-free core.

When should I use SDK?

SDK fits situations like: tasks that involve Test-driven development; tasks that involve API design.

How do I install SDK in Claude Code?

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

How do I install SDK in Codex?

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

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

What does SDK need to run?

Going by SKILL.md and its folder, SDK needs the command-line tools its instructions call (pnpm, npm, bun and tsc) and credentials named NODE_AUTH_TOKEN. Our summary lists: Node.js.

Does SDK access the network?

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

Is SDK safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does SDK use?

SDK has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does SDK use?

About 9.6k tokens (SKILL.md is roughly 38k 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 SDK?

Skills that share tags, products or a category with SDK: Dev (serithemage/serverless-openclaw, 196 stars), TDD (RafaelGB/Obsidian-ZettelFlow, 174 stars), Implement (RafaelGB/Obsidian-ZettelFlow, 174 stars) and Test Driven Development (johnku2011/boilerplates-with-ai-skills, 240 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains SDK?

kortix-ai (a GitHub organization) maintains it in kortix-ai/suna, which has 20,263 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 9, 2026.

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

SDK

Install SDK

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

Files

Compare with similar skills

Similar skills

Dev

TDD

Implement

Test Driven Development

Tasks

Design An API

More from kortix-ai/suna

Ponytail Review

Kortix Brand

Testing

Contributing

Claude Code

Learnings

Questions about SDK

Install SDK

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

Files

Compare with similar skills

Similar skills

More from kortix-ai/suna

Related

Questions about SDK