Agent skill

Skillshare

by runkids in runkids/skillshare

Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI.

MITAuto-check passedAgent Workflows

Install Skillshare

skills CLI
$ npx skills add runkids/skillshare --skill skillshare -a claude-code

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

GitHub CLI
$ gh skill install runkids/skillshare skillshare --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/runkids/skillshare.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/skillshare .claude/skills/skillshare && 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
skillshare
GitHub stars
2.7k
Token cost
~2.2k tokens
SKILL.md length
812 words
Files
17 (incl. scripts, references)
Skills in repo
5
Repo updated
First seen
Licence
MIT

At a glance

Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI.

  • Works in 6 steps: Choose noninteractive inputs. Supply… → Keep previews separate from writes. Use… → Inspect audit blocks. Review findings… → …
  • The user asks to configure
  • SKILL.md covers Scope and resource selection, Execution rules, Common workflows and References
  • Runs Shell scripts from its folder

What it does

Skillshare is an agent skill from runkids/skillshare. Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI. Use when the user asks to configure or run Skillshare, install or sync resources across AI tools, manage shared memory notes, import MCP settings, manage targets, audit skills, recover backups, or troubleshoot Skillshare configuration and sync. Covers global and project modes, noninteractive automation, and guidance for the terminal UI.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including scripts and reference files (for example `references/TROUBLESHOOTING.md`, `references/audit.md` and `references/backup.md`).

It sits in Agent Workflows, covering Backup and disaster recovery, Skill management and MCP servers. It works with Model Context Protocol. The repository describes itself as: 📚 Sync skills, agents, MCP, plugins to all AI CLI tools with one command and simplify team sharing. The licence is MIT.

When your agent uses it

  • The user asks to configure
  • Sync resources across AI tools
  • Manage shared memory notes
  • Import MCP settings

Example prompts

  • “/skillshare”

Requirements

  • A Bash shell

Workflow steps

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

  1. Choose noninteractive inputs. Supply names and selection flags supported by the
  2. Keep previews separate from writes. Use --dry-run where supported. After changing
  3. Inspect audit blocks. Review findings before choosing an override. install --json
  4. Use the matching recovery mechanism. Uninstalled skills go to trash; native MCP
  5. Keep credentials out of MCP definitions. Use {fromEnv: VARIABLE} references.
  6. Respect operation scope. Local configuration work does not imply permission to

What it can do on your machine

Read from SKILL.md and the folder at commit 2cda6ee. 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/ (Shell), 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

Skillshare loads about 2.2k tokens when it runs, and up to ~32k if it reads all its reference files. Until then it costs about 112 tokens; SKILL.md has 812 words of instructions outside code blocks.

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

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

The full file from runkids/skillshare at commit 2cda6ee, republished under its MIT licence (© runkids). 812 words, ~2,217 tokens.

Download SKILL.mdSave it as .claude/skills/skillshare/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
skillshare
description
Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI. Use when the user asks to configure or run Skillshare, install or sync resources across AI tools, manage shared memory notes, import MCP settings, manage targets, audit skills, recover backups, or troubleshoot Skillshare configuration and sync. Covers global and project modes, noninteractive automation, and guidance for the terminal UI.
argument-hint
[command] [target] [--json] [--dry-run] [-p|-g]
metadata.version
v0.25.1

Skillshare CLI

Use Skillshare to maintain a source and distribute resources to configured targets. Read only the reference relevant to the requested operation; the routing table is below. Check skillshare <command> --help if the installed version differs from these examples.

Scope and resource selection

  • Global config: ~/.config/skillshare/config.yaml. Project config: .skillshare/config.yaml or skillshare/config.yaml; hidden wins when both exist. Use -g or -p explicitly when location matters instead of relying on auto-detection.
  • Skills are directories containing SKILL.md; agents are single Markdown files. Source paths can be customized. Use the configured sources instead of assuming defaults.
  • Use native agents targets for agents. Use extras for arbitrary file resources or when flattening/content transformation is required; extension: works only on extras targets.
  • Shared memory notes live in the memory extra. Use extras memory to manage Markdown notes and reading guidance; nested paths such as wiki/architecture.md are supported. Read extras.md for scope, version checks, and agent setup.
  • MCP uses its own receiving targets and source definitions. Read mcp.md before editing MCP settings or importing native configurations. Its Agent notes cover what is specific to Claude Code, Codex, OpenCode and Pi: scopes and files, names and credentials they refuse, Pi's built-in MCP and piOptions, OMP's native MCP and preserved enable/disable lists, the portable tools policy, upgrading Pi settings from 0.22, turning a global server off in one project, mcp.projects for many folders from one config, and mcp serve for Agents that cannot reach the synced skill folders.
  • Plugins keep their native components together. Read plugins.md for installation, import, sync selection, updates, and native compatibility limits across Claude, Codex, Cursor, Antigravity, Pi, OMP, and OpenCode, including Pi packages from pi.dev and OMP marketplace plugins and standalone extension selection.
  • Hooks preserve each Agent's native event map or extension/plugin code. Read hooks.md before import, synchronization or recovery.

Execution rules

  1. Choose noninteractive inputs. Supply names and selection flags supported by the specific command. Use --no-tui for plain output or --json where supported. Do not add --force simply to avoid a prompt: it can overwrite conflicts or override audits.
  2. Keep previews separate from writes. Use --dry-run where supported. After changing skills or agents, sync the intended resource and scope. MCP and hooks mutations save source only unless --sync is supplied; sync --all also includes extras, MCP and hooks, but excludes plugins.
  3. Inspect audit blocks. Review findings before choosing an override. install --json permits overwrite and selects all when no skill/agent filter is given, but retains the audit gate; it is not merely an output format. Read install.md and audit.md before using it for automation.
  4. Use the matching recovery mechanism. Uninstalled skills go to trash; native MCP entries use MCP backups. Do not substitute filesystem deletion for CLI uninstall.
  5. Keep credentials out of MCP definitions. Use {fromEnv: VARIABLE} references. Managing settings does not require resolving secrets, copying OAuth credentials, starting servers, or probing their tools.
  6. Respect operation scope. Local configuration work does not imply permission to commit, push, or publish. Run those commands when included in the user's request.
Show full SKILL.md (310 more words)Show less

Common workflows

Inspect and diagnose
bash
skillshare status --json
skillshare list --json
skillshare diff --json
skillshare doctor --json
skillshare mcp --json

doctor exits 1 when it finds errors. Audit uses --format json; JSON flags and TUI availability vary by command. See the relevant reference rather than assuming parity.

Install, update, and sync skills
bash
skillshare install user/repo -s pdf,commit
skillshare install user/repo --track -b develop --all
skillshare sync
skillshare check --json
skillshare update my-skill
skillshare sync

For project setup, use init -p, then install -p and sync -p. Rehydrate configured remote dependencies with install without a source. For full flag details and agents, read install.md and sync.md.

To use a local skills checkout in place, run skillshare link <path> --enable, then sync; skillshare unlink <name> removes only the link. Read TROUBLESHOOTING.md for how such links are followed.

Disable or remove
bash
skillshare disable 'draft-*' --dry-run
skillshare disable 'draft-*'
skillshare enable 'draft-*'
skillshare uninstall my-skill
skillshare sync
skillshare trash restore my-skill
skillshare sync

Run the requested operation, not this entire example sequence. Quote glob patterns so Skillshare receives them unchanged. Disabling uses ignore rules; uninstall uses trash.

MCP settings
bash
skillshare mcp import --from claude --json
skillshare mcp add docs --url https://example.com/mcp --target claude --no-tui
skillshare sync mcp --dry-run --json
skillshare sync mcp

--target is singular and repeatable. A preview does not apply changes. For revisions, editing, import conflicts, credentials, backups, and human-operated TUI commands, read mcp.md.

Complete plugins
bash
skillshare plugin list --json
skillshare plugin add ./my-plugin --target claude --dry-run --json
skillshare plugin disable demo --target claude --no-tui
skillshare sync plugins demo --dry-run --json

Run only the requested operation. add installs a whole native package; import adopts an existing installation. Plugin enable/disable saves sync selection only; the next sync plugins installs or removes the managed target. It is excluded from sync --all. Inspect targetDefinitions for supported operations and scopes; format discovery alone does not mean installation is supported. Read plugins.md before applying changes.

Skill hubs
bash
skillshare hub add https://example.com/hub.json          # Save a hub source
skillshare hub add https://example.com/hub.json --label my-hub  # With custom label
skillshare hub add git@ghe.corp.com:team/skills.git --label ghe  # SSH/private/GHE hub source
skillshare hub list                                      # List saved hubs
skillshare hub default my-hub                            # Set default hub
skillshare hub remove my-hub                             # Remove a hub
skillshare hub index --source ~/.config/skillshare/skills/ --full --audit  # Build hub index

The active follow_source_links setting also applies to hub index (including --source), built-in dashboard search, and Hub draft candidates.

References

Read the matching file for command flags, examples, and limitations. Avoid loading all references for a single task.

TopicFile
Native agents, selection, ignore rules, and recoverynative-agents.md
MCP configuration, imports, TUI, and recoverymcp.md
Native hooks, code bindings, scopes and recoveryhooks.md
Complete plugins, native lifecycle, and sync selectionplugins.md
Init flagsinit.md
Sync/collect/commit/push/pullsync.md
Install/update/uninstall/newinstall.md
Status/diff/list/search/checkstatus.md
Security auditaudit.md
Trashtrash.md
Operation loglog.md
Targetstargets.md
Extras (rules/commands/prompts)extras.md
Backup/restorebackup.md
TroubleshootingTROUBLESHOOTING.md

© runkids, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 16 other files (scripts, references) in skills/skillshare of runkids/skillshare.

  • SKILL.md
  • references/TROUBLESHOOTING.md
  • references/audit.md
  • references/backup.md
  • references/extras.md
  • references/hooks.md
  • references/init.md
  • references/install.md
  • references/log.md
  • references/mcp.md
  • references/native-agents.md
  • references/plugins.md
  • references/status.md
  • references/sync.md
  • references/targets.md
  • references/trash.md
  • scripts/run.sh

Open the folder on GitHubat commit 2cda6ee

Compare with similar skills

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

Skillshare compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Skillshare this skillrunkids/skillshare2.7k—~2.2kAutomated safety check: PassMIT
PicoClaw Agentsipeed/picoclaw30k—~7.2kAutomated safety check: NotesMIT
AgentSkillsHub Skill Finderzhuyansen/agent-skills-hub407—~1kAutomated safety check: PassMIT
Sandboxed.sh Library ManagementTh0rgal/sandboxed.sh515—~931Automated safety check: PassNone
Mistral Vibe CLI Referencemistralai/mistral-vibe5.1k—~14kAutomated safety check: NotesApache-2.0
Skill Routerstevesolun/ctx588—~2.4kAutomated safety check: PassMIT

Similar skills

  • PicoClaw Agent

    sipeed/picoclaw

    Answers questions about running and changing PicoClaw, from onboarding and model selection to MCP server setup, skill loading and scheduled jobs.

    30k GitHub stars~7.2k tokensUpdated 13 days ago
    Agent WorkflowsAuto-check: notes
  • AgentSkillsHub Skill Finder

    zhuyansen/agent-skills-hub

    Searches a locally cached, security-graded catalog of agent skills and MCP servers, and returns install commands after checking each one's grade.

    407 GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Reads and updates the Sandboxed.sh Library, a git-backed store of skills, agents, commands, tools, rules and MCP servers, through its library tools.

    515 GitHub stars~931 tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Mistral Vibe CLI Reference

    mistralai/mistral-vibe

    Official

    Reference for Mistral Vibe, the CLI agent it runs inside: config files, env vars, agents, skills, tools, hooks and MCP servers, so the agent can explain and troubleshoot its own setup.

    5.1k GitHub stars~14k tokensUpdated yesterday
    Agent WorkflowsAuto-check: notes
  • Skill Router

    stevesolun/ctx

    Repo-aware recommendation manager for ctx. An agent skill from stevesolun/ctx.

    588 GitHub stars~2.4k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check passed
  • Superset Plugins and Tools

    superset-sh/superset

    Installs Superset plugins, connects the accounts they need and calls their MCP tools through the credential proxy, without writing tokens to your machine.

    15k GitHub stars~1.3k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from runkids/skillshare

  • Skillshare UI Website Style

    runkids/skillshare

    Skillshare frontend design system for the React dashboard (ui/) and Docusaurus website (website/).

    2.7k GitHub stars~4.5k tokensUpdated today
    Auto-check passed
  • Skillshare Changelog

    runkids/skillshare

    Generate CHANGELOG.md entry from recent commits in conventional format.

    2.7k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Skillshare Release

    runkids/skillshare

    Prepare and review skillshare releases using the Release Please PR, verify the proposed version and changelog, inspect draft assets, and publish through the manual Publish Release workflow when…

    2.7k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Skillshare Windows Utm

    runkids/skillshare

    Verify skillshare on a real Windows guest running in local UTM: build a pinned commit in the devcontainer, push it into the VM, and either run the Windows E2E runbook with full and basic-user tokens…

    2.7k GitHub stars~1.6k tokensUpdated today
    Auto-check passed

Categories

Questions about Skillshare

What does Skillshare do?

Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI. Skillshare is an agent skill from runkids/skillshare. Manage skills, agents, extras, hooks, plugins, and MCP connection settings with the Skillshare CLI.

When should I use Skillshare?

Skillshare fits situations like: the user asks to configure; sync resources across AI tools; manage shared memory notes; import MCP settings.

How do I install Skillshare in Claude Code?

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

How do I install Skillshare in Codex?

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

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

What does Skillshare need to run?

Going by SKILL.md and its folder, Skillshare needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Skillshare 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 Skillshare 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 Skillshare use?

Skillshare is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Skillshare use?

About 2.2k tokens (SKILL.md is roughly 8.9k 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 30k tokens, read only when the agent opens those files.

What are the alternatives to Skillshare?

Skills that share tags, products or a category with Skillshare: PicoClaw Agent (sipeed/picoclaw, 30k stars), AgentSkillsHub Skill Finder (zhuyansen/agent-skills-hub, 407 stars), Sandboxed.sh Library Management (Th0rgal/sandboxed.sh, 515 stars) and Mistral Vibe CLI Reference (mistralai/mistral-vibe, 5.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Skillshare?

runkids (a GitHub user) maintains it in runkids/skillshare, which has 2,724 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on October 7, 2026.

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