skillshare
- Repo stars 1,897
- Author updated Live
- Author repo skillshare
- Domain
- Other
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @runkids · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Unspecified (assume cross-platform)
- Runtime requirements
- No special requirements
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: skillshare
description: | Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local.…
category: other
runtime: no special runtime
---
# skillshare output preview
## PART A: Task fit
- Use case: | Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local. Auto-detects project mode when .skillshare/config.yaml exists. Force with -p or -g. runs entirely locally. Works with Claude Code, Cursor, Cline and 23 more..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “Recipes / Getting Started / Installing Skills” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “| Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local. Auto-detects project mode when .skillshare/config.yaml exists. Force with -p or -g. runs entirely locally. Works with Claude Code, Cursor, Cline and 23 more.”.
- **02** When the source has headings, the agent prioritizes “Recipes / Getting Started / Installing Skills” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source does not require a stable slash command. After installation, invoke the skill by name and describe the task.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “Recipes / Getting Started / Installing Skills”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: skillshare
description: | Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local.…
category: other
source: runkids/skillshare
---
# skillshare
## When to use
- | Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local. Auto-detects project…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “Recipes / Getting Started / Installing Skills” and keep inference separate from source facts.
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "skillshare" {
input -> user goal + target files + boundaries + acceptance criteria
context -> Recipes / Getting Started / Installing Skills
rules -> SKILL.md triggers / order / output contract
runtime -> no special runtime | read files, write/modify files | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} Skillshare CLI
Global: ~/.config/skillshare/skills/ → all AI CLIs. Project: .skillshare/skills/ → repo-local.
Auto-detects project mode when .skillshare/config.yaml exists. Force with -p or -g.
Recipes
Getting Started
skillshare init --no-copy --all-targets --git --skill # Fresh global setup
skillshare init -p --targets "claude,cursor" # Fresh project setup
skillshare init --copy-from claude --all-targets --git # Import from existing CLI
skillshare init --discover --select "windsurf" # Add new AI tool later
Installing Skills
skillshare install user/repo -s pdf,commit # Select specific skills
skillshare install user/repo --all # Install everything
skillshare install user/repo --into frontend # Place in subdirectory
skillshare install gitlab.com/team/repo # Any Git host
skillshare install user/repo --track # Enable `update` later
skillshare install user/repo -b develop --all # Install from branch
skillshare install user/repo --track -b develop # Track specific branch
skillshare install user/repo -s pdf -p # Install to project
skillshare install # Reinstall all tracked remotes from config
skillshare sync # Always sync after install
Extras (Rules, Commands, Prompts)
skillshare extras init rules --target ~/.claude/rules --target ~/.cursor/rules
skillshare extras init commands --target ~/.claude/commands --mode copy
skillshare extras init rules --target ~/.claude/rules --source ~/shared/rules # custom source (global only)
skillshare extras init rules --target ~/.cursor/rules --force # overwrite existing
skillshare extras init # Interactive TUI wizard (incl. source step)
skillshare extras source # Show current extras_source
skillshare extras source ~/shared/extras # Set global extras_source
skillshare extras list # Show status per target
skillshare extras list --json # JSON with source_type field
skillshare extras collect rules # Pull local files into source
skillshare extras remove rules # Remove from config (source preserved)
skillshare extras init agents --target ~/.claude/agents --flatten # Flatten subdirs into root
skillshare extras rules --mode copy # Change sync mode of a target
skillshare extras agents --flatten # Enable flatten on existing target
skillshare sync extras # Sync all extras to targets
skillshare sync extras --dry-run --force # Preview / overwrite conflicts
skillshare sync --all # Sync skills + extras together
A target can set an extension: field in config.yaml to transform each source file during sync (e.g. markdown → TOML for Gemini/Codex); implies copy mode. See extras.md for details.
Creating & Discovering Skills
skillshare new my-skill # Create with interactive pattern selection
skillshare new my-skill -P reviewer # Use reviewer pattern directly
skillshare search "react testing" # Search GitHub for skills
skillshare collect # Pull target-local changes back to source
Removing Skills
skillshare uninstall my-skill # Remove one (moves to trash)
skillshare uninstall skill-a skill-b # Remove multiple
skillshare uninstall -G frontend # Remove entire group
skillshare sync # Always sync after uninstall
Enable / Disable Skills
skillshare disable draft-* # Hide from sync (adds to .skillignore)
skillshare enable draft-* # Restore (removes from .skillignore)
skillshare disable my-skill -p # Project mode
skillshare disable my-skill --dry-run # Preview
# TUI: press E in `skillshare list` to toggle
skillshare sync # Always sync after toggle
Team / Organization
# Creator: init project (see Getting Started) → add skills → commit .skillshare/
skillshare install -p && skillshare sync # Member: clone → install → sync
skillshare install github.com/team/repo --track -p # Track shared repo
skillshare commit -m "Update skill" # Local checkpoint, no push
skillshare push # Cross-machine: push on A
skillshare pull # Cross-machine: pull on B
Skill Hubs
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 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
Controlling Where Skills Go
# SKILL.md frontmatter: metadata.targets: [claude] → only syncs to Claude
skillshare target claude --add-include "team-*" # glob filter
skillshare target claude --add-agent-include "team-*" # agent glob filter
skillshare target claude --add-exclude "_legacy*" # exclude pattern
skillshare target claude --agent-mode copy # agents copy mode
skillshare target codex --mode copy && skillshare sync --force # copy mode
# .skillignore — hide skills/dirs from discovery (gitignore syntax)
# Root-level: <source>/.skillignore (affects all commands)
# Repo-level: <source>/_repo/.skillignore (scoped to that repo)
# .skillignore.local — local override (not committed), negation overrides base
See targets.md for details.
Updates & Maintenance
skillshare check # See what has updates
skillshare update my-skill && skillshare sync # Update one
skillshare update --all && skillshare sync # Update all
skillshare update --all --diff # Show what changed
Scripting & CI/CD
skillshare status --json # Full status as JSON
skillshare check --json # Update status as JSON
skillshare sync --json # Sync results as JSON
skillshare diff --json # Diff results as JSON
skillshare install user/repo --json # Install result as JSON (implies --force --all)
skillshare update --all --json # Update results as JSON
skillshare uninstall my-skill --json # Uninstall result as JSON (implies --force)
skillshare collect claude --json # Collect result as JSON (implies --force)
skillshare target list --json # Target list as JSON
skillshare list --json # Skill list as JSON
skillshare search react --json # Search results as JSON
skillshare audit --format json # Audit results as JSON
skillshare doctor --json # Health check as JSON (exit 1 on errors)
Recovery & Troubleshooting
skillshare trash restore <name> && skillshare sync # Undo delete
skillshare sync # Skill missing? Re-sync
skillshare doctor && skillshare status # Diagnose issues
skillshare install user/repo --force # Override audit block
skillshare install user/repo --skip-audit # Bypass scan entirely
See TROUBLESHOOTING.md for more.
Quick Lookup
| Commands | Project? | --json? |
|---|---|---|
status, diff, list, doctor |
✓ (auto) | ✓ |
sync, collect |
✓ (auto) | ✓ |
install, uninstall, update, check, search, new |
✓ (-p) |
✓ (except new) |
target, audit, analyze, trash, log, hub |
✓ (-p) |
✓ (target list, audit, analyze, log) |
extras init/list/remove/collect/source/mode |
✓ (-p, except source) |
✓ (list, mode) |
enable, disable |
✓ (auto) | ✗ |
commit, push, pull, backup, restore |
✗ | ✗ |
tui, upgrade |
✗ | ✗ |
ui |
✓ (-p) |
✗ |
AI Caller Rules
- Non-interactive — AI cannot answer prompts. Use
--force,--all,-s,--targets,--no-copy,--all-targets,--yes. - Sync after mutations —
install,uninstall,update,collect,targetall needsync. - Audit —
installauto-scans; CRITICAL blocks.--forceto override,--skip-auditto bypass. Detects hardcoded secrets (API keys, tokens, private keys). - Uninstall safely — moves to trash (7 days).
trash restore <name>to undo. NEVERrm -rfsymlinks. - Output —
--jsonfor structured data (12 commands support it, see Quick Lookup).--no-tuifor plain text on TUI commands (list,log,audit,analyze,diff,trash list,backup list,target list).tui offdisables TUI globally.--dry-runto preview.
References
| Topic | File |
|---|---|
| Init flags | init.md |
| Sync/collect/commit/push/pull | sync.md |
| Install/update/uninstall/new | install.md |
| Status/diff/list/search/check | status.md |
| Security audit | audit.md |
| Trash | trash.md |
| Operation log | log.md |
| Targets | targets.md |
| Extras (rules/commands/prompts) | extras.md |
| Backup/restore | backup.md |
| Troubleshooting | TROUBLESHOOTING.md |
Decide Fit First
Design Intent
How To Use It
Boundaries And Review