Open source · Private by default

Share skills, agents
and whole swarms,
one private repo at a time

skylls publishes every skill, agent and swarm you make for Claude Code, Codex and Gemini to its own private GitHub repo — and shares each one with exactly the friends you choose.

Read the Docs Star on GitHub
npm install -g @skylls/cli
curl -fsSL https://skylls.dev/install.sh | bash

or the one-line installer (checks git, gh and gitleaks, then runs setup)

One network

People and agents, sharing with each other

Everyone on skylls can share what they built and install what friends shared: a single skill, a whole agent with its memory, or a full swarm, across Claude Code, Codex and Gemini. Each item goes through its own private repo, to exactly who you chose.

People and AI agents around skylls exchange skills, whole agents and swarms, each through its own private GitHub repo

Share anything

From one skill to a whole swarm

Whatever you built for your agents travels in one command: a single skill, an agent with its memory, or a full team of agents. Your friend gets a working copy, not a zip file to untangle.

Skill

One skill, versioned

Friends install it for Claude Code, Codex and Gemini at once and get every new version with one pull.

  • SKILL.md + files
  • versions
  • changelog
  • summary
$ skylls share seo-audit @bob
Agent

A whole agent, with its memory

Its instructions, settings, scripts and Obsidian memory travel together. Runtime state stays home.

  • definition
  • skills it uses
  • Obsidian memory
$ skylls agents share lead-generator @bob
Swarm

A full team of agents

Share the coordinator, every agent and their shared memory as one item. Your friend launches the same team.

  • every agent
  • roles
  • shared memory
$ skylls swarms share marketing-team @carol

Friends or agents

Made for people and for their agents

Share with the friends you choose, item by item. Or let your agents do it: the skylls skill teaches Claude Code, Codex and Gemini to find and install what they need on their own.

Friends

Each friend sees only what you shared with them, nothing else. They can suggest changes; you decide what goes into the next version.

Agents

agent › I need an SEO audit of this site.
$ skylls find seo --json
{"name":"seo-audit","owner":"you-skylls","version":"1.2.0",
"summary":"Audits a site's SEO and lists fixes"}
$ skylls add seo-audit -g -a claude
✓ Installed 'seo-audit' → ~/.claude/skills/seo-audit
agent › Got it. Running the seo-audit skill…

Agents read compact --json and follow the skylls skill, so a friend's agent can pick up the skill you just shared without anyone copying files around.

Private by default

Your skills, your repos, your rules

GitHub stores everything and decides who can see what. skylls adds versions, changelogs, plain summaries, folders, suggestions and a secret scan on top.

One private repo per item

Every skill, agent and swarm gets its own private repo — skill-pdf, agent-lead-generator — created the first time you publish it. Nothing is shared until you share it.

Share item by item

skylls share pdf @bob lets Bob install that one skill — not your other skills, agents or swarms. Revoke any time. With an organization, friends get read-only access.

Secret scan before every push

API keys, tokens, passwords and personal data are caught with gitleaks before anything leaves your machine. If something is found, nothing is published.

Agents and swarms, with memory

Share a whole agent or swarm: its instructions, .claude/ and scripts plus its Obsidian memory — never its logs, data or private settings.

Versions and changelogs

Every push is a new version with a note of what changed, when and by whom, and a one-sentence summary written by Claude. Older versions stay installable.

Claude Code, Codex and Gemini

Install for one project or globally; one real copy plus links for every agent CLI you use. Folders, suggestions and --json output for agents included.

Quick start

From your machine to a friend's in a minute

Set up once, then publish, share and install with one command each.

Install & set up

Install with npm, then skylls setup. It recommends a free GitHub organization to hold your repos and shows you how to make one.

Publish

skylls push pdf scans for secrets and publishes your skill to its own private repo as v1.0.0. Agents and swarms: skylls agents push lead-generator.

Share

skylls share pdf @bob invites Bob to that one repo — from the terminal or from the dashboard.

Your friend installs

Bob runs skylls source add you once, then skylls add pdf -g -a all. Updates arrive with skylls pull --update.

Organized on GitHub

An organization works like a folder

Every item is an independent private repo, so a friend you share one skill with can't see the rest. Group them further with folders (GitHub topics).

github.com/you-skylls ← your organization ├── skill-pdf private shared with @bob (read-only) ├── skill-invoices private folder: work ├── agent-lead-generatorprivate definition + Obsidian memory └── swarm-marketing-teamprivate not shared

Two terminals

You share, your friend installs

Everything also works for agents and swarms: skylls agents …, skylls swarms ….

you
# publish a skill (secret scan first)
$ skylls push pdf -m "Handles scans"
✓ No secrets or private info found.
✓ Published pdf v1.1.0 → you-skylls/skill-pdf

# share it with one friend
$ skylls share pdf @bob
✓ Invited @bob (read-only)

# answer their suggestions
$ skylls suggestions
pdf#3  Support Excel files  by @bob
$ skylls accept pdf#3 -m "Done in 1.2.0"
your friend
# see what you shared (accepts the invite)
$ skylls source add you-skylls
✓ Added you-skylls: 1 skills

# install for Claude Code, Codex and Gemini
$ skylls add pdf -g -a all
✓ Installed 'seo-audit' → ~/.claude/skills/seo-audit

# later: get new versions
$ skylls pull --update
pdf: v1.1.0 → v1.2.0

See everything you share

Sign in with GitHub to see your skills, agents and swarms, who can see each one, invitations from friends and open suggestions.

Open Dashboard