Agent skill

Contributing

by kortix-ai in kortix-ai/suna

The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach →…

Custom licenceAuto-check: warningsDevelopment

Install Contributing

The automated check flagged lines worth reading first. See the safety section below.

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

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

GitHub CLI
$ gh skill install kortix-ai/suna contributing --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/contributing .claude/skills/contributing && 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
contributing
GitHub stars
20k
Used in
1 other repo
Token cost
~3k tokens
SKILL.md length
1,424 words
Files
8 (incl. scripts, references)
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach →…

  • Works in 8 steps: Branch and worktree → Commit → Verify in your box → …
  • Tasks that involve Pull requests
  • SKILL.md covers Preflight (once per machine), Steps, What runs where and Labels
  • Runs Shell and TypeScript scripts from its folder; calls gh, git and pnpm; reaches github.com

What it does

Contributing is an agent skill from kortix-ai/suna. The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach → self-merge → verify on dev. A PR into main runs no CI unless a person adds the test or preview label (one run each). Load when opening, updating, or finishing a pull request; when writing a PR body; when asking what CI runs where; when adding or explaining PR labels or the per-PR preview environment; or when attaching…

Its SKILL.md is about 3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including scripts and reference files (for example `references/attachments.md`, `references/preview-environments.md` and `scripts/preview-auth-email.sh`).

It sits in Development, covering Pull requests, Video production and Browser automation. It works with Git and pnpm. The repository describes itself as: The open-source AI Operating System.

When your agent uses it

  • Tasks that involve Pull requests
  • Tasks that involve Video production
  • Tasks that involve Browser automation

Example prompts

  • “/contributing”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

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

  1. Branch and worktree
  2. Commit
  3. Verify in your box
  4. Record the demo video on the local stack
  5. Open the PR
  6. Attach the video to the PR
  7. Keep it current
  8. Merge and hand off

What it can do on your machine

Read from SKILL.md and the folder at commit 0b76bd5. 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

    Ships 5 files in scripts/ (Shell and TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • gh
    • git
    • pnpm
    • terraform

    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:

    • github.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

Contributing loads about 3k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 145 tokens; SKILL.md has 1,424 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~145
When it runs · the whole SKILL.md, loaded when a task matches
~3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.4k

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

The automated check found patterns that need a careful read before installing.

  • NoteMentions a .env fileSKILL.md:44
    s `.githooks`. The hooks encrypt staged `.env` files, block plaintext
  • WarningTells the agent its actions are pre-authorized / not to stop for confirmationSKILL.md:183
    checks passed and the PR is mergeable. Do not wait for the user's approval, and do

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); the scripts in this folder 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 1,424 words (~3,026 tokens).

“Every change reaches main through a pull request. A pull request into main runs no GitHub Actions job: your development machine runs every test, the stack, and the demo before the PR opens, and the PR is mergeable at once…”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (scripts, references) in .agents/skills/contributing of kortix-ai/suna.

  • SKILL.md
  • references/attachments.md
  • references/preview-environments.md
  • scripts/preview-auth-email.sh
  • scripts/preview-origin.sh
  • scripts/preview-sign-in.sh
  • scripts/preview-subscribe.sh
  • scripts/preview-subscribe.ts

Open the folder on GitHubat commit 0b76bd5

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in kortix-ai/suna, which our catalogue first saw on October 7, 2026.

Compare with similar skills

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

Contributing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Contributing this skillkortix-ai/suna20k1 repos~3kAutomated safety check: WarnCustom licence
Verdaccio Pull Request Workflowverdaccio/verdaccio18k—~1.9kAutomated safety check: PassMIT
ZCF Release AutomationUfoMiao/zcf6.1k—~3.4kAutomated safety check: PassMIT
Review And Fix PRpnpm/pnpm37k—~796Automated safety check: PassMIT
Check Pushpockethost/pockethost1.4k—~665Automated safety check: PassMIT
Changesets Pull Request to Mainbreaking-brake/cc-wf-studio5.4k—~1.4kAutomated safety check: PassCustom licence

Similar skills

  • Takes a change through a verdaccio pull request: branch, local checks, changeset, title and body, labels, CI and review rounds, and ports to other release lines.

    18k GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Automates a version release with changesets: analyzes code changes, writes a bilingual CHANGELOG, bumps the version and commits through a release branch and pull request.

    6.1k GitHub stars~3.4k tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Review and fix an existing pnpm pull request, rebase it, commit and push fixes, then follow CI and review to completion.

    37k GitHub stars~796 tokensUpdated today
    DevelopmentAuto-check passed
  • Check Push

    pockethost/pockethost

    Run pnpm check:push (lint, types, tests) before git push or PR-ready work.

    1.4k GitHub stars~665 tokensUpdated 10 days ago
    DevelopmentAuto-check passed
  • Changesets Pull Request to Main

    breaking-brake/cc-wf-studio

    Opens a pull request to main in a pnpm and Changesets monorepo, after working out which packages changed and making sure a changeset file exists.

    5.4k GitHub stars~1.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Dsh Web Pre Push Checks

    zhu1090093659/dsh-web

    Use before pushing, opening or updating a pull request, or claiming dsh-web checks pass.

    8.5k GitHub stars~851 tokensUpdated today
    DevelopmentAuto-check passed

More from kortix-ai/suna

All 19 skills in this repo
  • Ponytail Review

    kortix-ai/suna

    Code review focused exclusively on over-engineering. An agent skill from kortix-ai/suna.

    20k GitHub starsUsed in 4 repos~593 tokens
    Auto-check passed
  • Kortix Brand

    kortix-ai/suna

    Load FIRST for anything that carries the Kortix look or voice: product or mobile UI, copy of any kind, decks, social, images, email, CLI output, anything with the logo, and reviews of these.

    20k GitHub stars~4k tokensUpdated today
    Auto-check passed
  • Testing

    kortix-ai/suna

    A skill your agent uses for every Kortix test task, behavior change, bug fix, refactor, API route change, CLI change, SDK change, browser journey, test failure, coverage question, local benchmark…

    20k GitHub stars~3.6k tokensUpdated today
    Auto-check: notes
  • Claude Code

    kortix-ai/suna

    Drive Anthropic's Claude Code CLI (claude -p) as a non-interactive coding sub-agent from inside Codex.

    20k GitHub starsUsed in 1 repo~1.2k tokens
    Auto-check passed
  • Learnings

    kortix-ai/suna

    The project's episodic memory: a timestamped ledger of rules paid for with real outages and near-misses, one entry per incident.

    20k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Kortix Presentation

    kortix-ai/suna

    Recipe: build, edit, present or record a Kortix deck or film (a Next.js route under /presentations in apps/web, never a file).

    20k GitHub stars~3k tokensUpdated today
    Auto-check passed

Works with

Categories

Questions about Contributing

What does Contributing do?

The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach →…. Contributing is an agent skill from kortix-ai/suna. The pull request loop for this repo: branch → commit → verify in your own box (local tests + local stack) → PR into main → demo video recorded with agent-browser on the local stack → gh --attach → self-merge → verify on dev.

When should I use Contributing?

Contributing fits situations like: tasks that involve Pull requests; tasks that involve Video production; tasks that involve Browser automation.

How do I install Contributing in Claude Code?

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

How do I install Contributing in Codex?

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

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

What does Contributing need to run?

Going by SKILL.md and its folder, Contributing needs a shell and TypeScript for the scripts in its folder and the command-line tools its instructions call (gh, git, pnpm and terraform). Our summary lists: Node.js; A Bash shell.

Does Contributing access the network?

SKILL.md names 1 domain. In commands or code: github.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Contributing safe to install?

Our automated static check of SKILL.md flagged 1 warning(s): tells the agent its actions are pre-authorized / not to stop for confirmation. Read the flagged lines before installing; the check is not a guarantee either way. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Contributing use?

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

About 3k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.4k tokens, read only when the agent opens those files.

What are the alternatives to Contributing?

Skills that share tags, products or a category with Contributing: Verdaccio Pull Request Workflow (verdaccio/verdaccio, 18k stars), ZCF Release Automation (UfoMiao/zcf, 6.1k stars), Review And Fix PR (pnpm/pnpm, 37k stars) and Check Push (pockethost/pockethost, 1.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Contributing?

kortix-ai (a GitHub organization) maintains it in kortix-ai/suna, which has 20,258 GitHub stars. The repository holds 19 skills in this directory. The repository was last updated on October 8, 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.