kortix-marketplace
The Kortix marketplace — how to discover capabilities and IMPORT them into this project. The marketplace is a catalog of open git repos: whole ready-made PROJECTS (registry:project) and individual ski
SKILL.mdpackages/starter/templates/managed/skills/kortix-marketplace/SKILL.md
GitHub<skill name="kortix-marketplace">
The Kortix marketplace is the Kortix-native catalog. Every item is an open
git repo made of plain files — a whole clonable project (its kortix.yaml,
agents, skills, tools) or an individual skill / agent / tool. There is no
deterministic installer, no version lock, and no update system: you add an item
by importing it — reading its source and merging what fits into this
project's own files, then opening a change request. Everything you import becomes
100% user-owned files in this repo, exactly like any other code you write.
Why it works this way: the Kortix system layer (this kortix-* family, the
kortix CLI) is served live and always-latest, so it never goes stale. Marketplace
items are the opposite — they're yours to own and edit, so they're imported as
files, not pinned to an upstream that could clobber your changes.
kortix marketplace search "<query>" --json # find items (parse the JSON)
kortix marketplace show <id> --json # inspect one item: type, files, source repo
Read-only. There is no install / update / remove subcommand anymore —
adding an item is the import flow below.
</discovery>
- Get the source. From
kortix marketplace show <id> --json, take the item's source git repo/ref (or its inline files). Clone/read it in the sandbox. - Detect what it is from its file structure:
- a
kortix.yamlat the repo root → a project (agents + skills + tools + config), - a
SKILL.md→ a skill, - an agent definition (an
agents/*.md) → an agent, - a tool file (a
tools/*.ts) → a tool.
- a
- Merge what fits into this project, in the right place:
- skills →
skills/<name>/, - agents →
agents/<name>.md, declared underagents:inkortix.yaml, - tools →
tools/<name>.ts, declared undertools:inkortix.yaml, so every harness runs it. An item written as an OpenCode tool (tool({ args, execute })) is converted to the harness-neutral contract (kortix-system→references/kortix/tools.md); keep it inharnesses/opencode/tools/only if it needs OpenCode-only context, - for a whole project: pull in its skills/agents/tools and reconcile its
kortix.yamlinto this project's (merge connectors/triggers/agents — never blindly overwrite the user's manifest). Use judgment; keep what's relevant. Projects created before 2026-09 keep agents, skills and tools under.kortix/opencode/. Both layouts work; put new files in the root layout.
- skills →
- Adapt it to this project. If a skill carries a "TODO: make this yours" placeholder or generic copy, tailor it to what this project actually does.
- Wire up its needs. If the item requires a connector/secret, don't hardcode
anything. A value the user already gave you goes in with
kortix secrets set NAME=-; otherwise mint a setup link (kortix secrets request …/kortix connectors connect …) and surface it. - Commit + open a CR.
git add/commit,git push origin HEAD, thenkortix cr open --title "Import <item>". The user reviews the diff and merges — that's how it becomes permanent (seekortix-systemfor the CR mandate).
Importing is just you reading files and writing files, landed through a change request. No lock file, no tracked "installed" state — git is the source of truth for what's in this project. </importing>
<projects> A whole **project** item is the richest thing in the marketplace — a working, end-to-end Kortix project focused on a function. You can spin it up as its **own new project** (from the web UI's "Add to a project" → new project, which seeds the files deterministically), or **import/merge it into this existing project** via the recipe above to make this project bigger. It's all just files. </projects> <adding-a-source> To make another registry's items discoverable here, add it as a **source** — any public git repo that ships `SKILL.md` files or a `marketplace.json` (e.g. `anthropics/skills`, community repos from skills.sh). Curated sources enable in one click; an arbitrary git URL is admin-gated. Once added, its items show up in `kortix marketplace search`, and you import them the same way. </adding-a-source> <outside-the-catalog> This skill covers the Kortix catalog: whole projects + skills/agents/tools, imported into this repo as owned files via a CR.When the catalog has nothing that fits, the wider open ecosystem is still fair
game — npx skills find "<query>" searches skills.sh, and a skill from there is
just a SKILL.md plus references, so it merges in through the exact same import
recipe above. Either way you end up importing plain files you own.
</outside-the-catalog>