技能分享
- 作者仓库星标 1,897
- 作者仓库 skillshare
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @runkids · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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
```bash
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
```bash
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)
```bash
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](references/extras.md) for details.
### Creating & Discovering Skills
```bash
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
```bash
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
```bash
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
```bash
# 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
```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 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
```bash
# 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](references/targets.md) for details.
### Updates & Maintenance
```bash
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
```bash
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
```bash
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](references/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
1. **Non-interactive** — AI cannot answer prompts. Use `--force`, `--all`, `-s`, `--targets`, `--no-copy`, `--all-targets`, `--yes`.
2. **Sync after mutations** — `install`, `uninstall`, `update`, `collect`, `target` all need `sync`.
3. **Audit** — `install` auto-scans; CRITICAL blocks. `--force` to override, `--skip-audit` to bypass. Detects hardcoded secrets (API keys, tokens, private keys).
4. **Uninstall safely** — moves to trash (7 days). `trash restore <name>` to undo. **NEVER** `rm -rf` symlinks.
5. **Output** — `--json` for structured data (12 commands support it, see Quick Lookup). `--no-tui` for plain text on TUI commands (`list`, `log`, `audit`, `analyze`, `diff`, `trash list`, `backup list`, `target list`). `tui off` disables TUI globally. `--dry-run` to preview.
## References
| Topic | File |
|-------|------|
| Init flags | [init.md](references/init.md) |
| Sync/collect/commit/push/pull | [sync.md](references/sync.md) |
| Install/update/uninstall/new | [install.md](references/install.md) |
| Status/diff/list/search/check | [status.md](references/status.md) |
| Security audit | [audit.md](references/audit.md) |
| Trash | [trash.md](references/trash.md) |
| Operation log | [log.md](references/log.md) |
| Targets | [targets.md](references/targets.md) |
| Extras (rules/commands/prompts) | [extras.md](references/extras.md) |
| Backup/restore | [backup.md](references/backup.md) |
| Troubleshooting | [TROUBLESHOOTING.md](references/TROUBLESHOOTING.md) |
章节与文件索引
按说明文件中的顺序排列。
附加功能(规则、命令、提示)
控制技能的去向
恢复与故障排除
快速查找
AI来电规则
文件/命令 -> ~/.config/skillshare/skills/ · .skillshare/skills/ · .skillshare/config.yaml · update · extension: · copy · skillshare list · --json
内容校验值 -> 74a78e849a1e
当前原文的自动摘译,尚未人工审校。
附加功能(规则、命令、提示)
目标可以设定一个
extension:config.yaml 中的字段用于在同步期间转换每个源文件(例如,Gemini/Codex 的 markdown → TOML);意味着copy模式。有关详细信息,请参阅 extras.md。控制技能的去向
有关详细信息,请参阅 Targets.md。
恢复与故障排除
有关更多信息,请参阅 TROUBLESHOOTING.md。
快速查找
命令·项目? ·
--json?status,diff,list,doctor· ✓(自动)· ✓sync,collect· ✓(自动)· ✓install,uninstall,update,check,search,new· ✓ (-p) · ✓(新的除外)target,audit,analyze,trash,log,hub· ✓ (-p) · ✓(目标列表、审核、分析、日志)AI来电规则
非交互式——人工智能无法回答提示。使用
--force,--all,-s,--targets,--no-copy,--all-targets,--yes。突变后同步 —install,uninstall,update,collect,target都需要sync。审计——install自动扫描;关键块。--force覆盖,--skip-audit绕过。检测硬编码秘密(API 密钥、令牌、私钥)。安全卸载 — 移至垃圾箱(7 天)。trash restore <name>撤消。从来没有rm -rf符号链接。