Agent skill

Learnings

by kortix-ai in 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.

Custom licenceAuto-check passedDevOps & Cloud

Install Learnings

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

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

GitHub CLI
$ gh skill install kortix-ai/suna learnings --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/learnings .claude/skills/learnings && 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
learnings
GitHub stars
20k
Token cost
~1.1k tokens
SKILL.md length
535 words
Files
656 (incl. scripts)
Skills in repo
19
Repo updated
First seen
Licence
Custom licence

At a glance

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

  • Works in 2 steps: Search the index and the full text for… → Read every matching entry in full. Obey…
  • Tasks that involve Incident response
  • SKILL.md covers Recall: before you touch a…, Record: after an incident or… and Ledger rules
  • Tasks that involve Database migrations

What it does

Learnings is an agent skill from 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. Load WHENEVER you write or review a DB migration or schema change, touch deploy/release workflows (.github/workflows/deploy-, promote.yml, vercel config), plan a promote/release, respond to a prod incident, or when another skill references a learning. ALSO load after resolving any incident or near-miss: it must leave a new ledger entry in the same session.

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 656 other files, including scripts (for example `MEMORY.md`, `entries/2026-08-10T191010Z-bot-pushed-release-prs-and-repo-actions-approval-policy.md` and `entries/2026-08-10T191010Z-cancel-the-ci-run-before-killing-its-db-backend.md`).

It sits in DevOps & Cloud, covering Incident response and Database migrations. It works with Vercel and GitHub Actions. The repository describes itself as: The open-source AI Operating System.

When your agent uses it

  • Tasks that involve Incident response
  • Tasks that involve Database migrations

Example prompts

  • “/learnings”

Workflow steps

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

  1. Search the index and the full text for the surface you are about to change
  2. Read every matching entry in full. Obey its Rule, and keep its Enforcement green.

What it can do on your machine

Read from SKILL.md and the folder at commit 10520d3. 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 1 file in scripts/, which the agent can run.

    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 no API keys, tokens, secrets or passwords.

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

Context cost

Learnings loads about 1.1k tokens when it runs. Until then it costs about 125 tokens; SKILL.md has 535 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~125
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 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); 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 535 words (~1,066 tokens).

“Every rule this repository paid for with downtime or a near-miss is one entry in a timestamped, append-only ledger. The ledger is the full history, in the order it was learned.”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 655 other files (scripts) in .agents/skills/learnings of kortix-ai/suna.

  • SKILL.md
  • MEMORY.md
  • entries/2026-08-10T191010Z-bot-pushed-release-prs-and-repo-actions-approval-policy.md
  • entries/2026-08-10T191010Z-cancel-the-ci-run-before-killing-its-db-backend.md
  • entries/2026-08-10T191010Z-cost-every-pending-prod-migration-before-promoting.md
  • entries/2026-08-10T191010Z-never-backfill-data-inside-a-single-transaction-migration.md
  • entries/2026-08-10T191010Z-node-pg-migrate-checkorder-is-index-wise-on-ledger-run-order.md
  • entries/2026-08-10T191010Z-the-prod-frontend-must-never-deploy-before-the-api-serves-th.md
  • entries/2026-08-10T191010Z-verify-ci-assertions-against-the-real-artifact-format-on-the.md
  • entries/2026-08-10T194745Z-an-audit-reconstruction-trigger-is-only-safe-with-its-dedup.md
  • entries/2026-08-10T194745Z-one-create-index-concurrently-per-table-at-a-time.md
  • entries/2026-08-10T194745Z-the-vercel-prod-build-must-be-handed-the-release-version.md
  • entries/2026-08-11T063009Z-a-deploy-workflow-must-not-cancel-a-build-it-cannot-outrun.md
  • entries/2026-08-11T120415Z-a-per-turn-hot-path-must-not-contain-an-unbounded-third-part.md
  • entries/2026-08-12T090712Z-a-cross-process-command-string-needs-a-test-that-runs-it.md
  • entries/2026-08-12T100900Z-a-deployed-api-is-not-a-deployed-daemon.md
  • entries/2026-08-13T075428Z-anything-created-per-deploy-needs-a-reaper-and-the-reaper-ne.md
  • entries/2026-08-13T202203Z-a-platform-injected-principal-must-never-have-its-authority.md
  • entries/2026-08-14T120355Z-a-tls-proxy-component-is-only-as-correct-as-the-third-party.md
  • entries/2026-08-14T120355Z-bun-diverges-from-node-in-three-load-bearing-ways-around-raw.md
  • … and 636 more

Open the folder on GitHubat commit 10520d3

Compare with similar skills

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

Learnings compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Learnings this skillkortix-ai/suna20k—~1.1kAutomated safety check: PassCustom licence
Use Vercel Actionamondnet/vercel-action764—~2.7kAutomated safety check: PassMIT
Deployments Cicdvercel/vercel-plugin3011 repos~3kAutomated safety check: PassCustom licence
Deploy Release Testvercel/next.js143k—~1.2kAutomated safety check: PassMIT
Deploy Setupgarrytan/gstack136k—~11kAutomated safety check: NotesMIT
Devops SpecialistCaoMeiYouRen/caomei-auth220—~446Automated safety check: NotesMIT

Similar skills

  • Use Vercel Action

    amondnet/vercel-action

    Wire amondnet/vercel-action into a GitHub Actions workflow to deploy Vercel projects from CI.

    764 GitHub stars~2.7k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Deployments Cicd

    vercel/vercel-plugin

    Official

    Vercel deployment and CI/CD expert guidance. An agent skill from vercel/vercel-plugin.

    301 GitHub starsUsed in 1 repo~3k tokens
    DevOps & CloudAuto-check passed
  • Deploy Release Test

    vercel/next.js

    Official

    Validate a commit-specific Next.js preview package and manually trigger the entire Next.js deployment test suite through the teste2edeployrelease.yml GitHub Actions workflow.

    143k GitHub stars~1.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Deploy Setup

    garrytan/gstack

    Detects where an app deploys, its production URL and health checks, then saves the deploy configuration in CLAUDE.md for /land-and-deploy.

    136k GitHub stars~11k tokensUpdated today
    DevOps & CloudAuto-check: notes
  • Devops Specialist

    CaoMeiYouRen/caomei-auth

    修改 Docker、CI/CD、部署配置、环境变量、运行时参数、构建脚本和发布流程时使用。优先覆盖 Docker、Vercel、Cloudflare 与 GitHub Actions 场景。用户提到 deploy、Dockerfile、workflow、CI、CD、environment variables、build pipeline、release config 时都应触发。

    220 GitHub stars~446 tokensUpdated 9 days ago
    DevOps & CloudAuto-check: notes
  • CI/CD Pipeline Principles

    irahardianto/awesome-agv

    Rules for designing CI/CD pipelines in layers: universal lint, test and scan stages, container builds with SBOM attestation, and GitOps for orchestrated deployments.

    156 GitHub stars~2.7k tokensUpdated 5 days ago
    DevOps & CloudAuto-check: notes

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

    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 →…

    20k GitHub stars~3k tokensUpdated today
    Auto-check: warnings
  • 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 stars~1.2k 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

Questions about Learnings

What does Learnings do?

The project's episodic memory: a timestamped ledger of rules paid for with real outages and near-misses, one entry per incident. Learnings is an agent skill from 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.

When should I use Learnings?

Learnings fits situations like: tasks that involve Incident response; tasks that involve Database migrations.

How do I install Learnings in Claude Code?

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

How do I install Learnings in Codex?

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

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

What does Learnings need to run?

SKILL.md names no scripts, command-line tools or credentials: Learnings is instructions for the agent only.

Does Learnings 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 Learnings 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Learnings use?

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

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

Skills that share tags, products or a category with Learnings: Use Vercel Action (amondnet/vercel-action, 764 stars), Deployments Cicd (vercel/vercel-plugin, 301 stars), Deploy Release Test (vercel/next.js, 143k stars) and Deploy Setup (garrytan/gstack, 136k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Learnings?

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