mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
4.9 KiB
4.9 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
Core Concepts
Understanding these concepts helps you get the most out of skillshare.
Overview
┌─────────────────────────────────────────────────────────────────┐
│ DUAL-LEVEL ARCHITECTURE │
│ │
│ ORGANIZATION LEVEL (global, cross-project) │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ Source: ~/.config/skillshare/skills/ │ │
│ │ ├── my-skill/ (personal) │ │
│ │ ├── _company-std/ (tracked: org-wide standards) │ │
│ │ └── _team-tools/ (tracked: team shared skills) │ │
│ └─────────────────────────────┬─────────────────────────────┘ │
│ sync ↓ │ ↑ collect │
│ ┌────────────────────┼────────────────────┐ │
│ ▼ ▼ ▼ │
│ ~/.claude/skills ~/.cursor/skills ~/.opencode/ │
│ (system-wide) (system-wide) (system-wide) │
│ │
│ PROJECT LEVEL (repo-scoped, shared via git) │
│ ┌───────────────────────────────────────────────────────────┐ │
│ │ Source: .skillshare/skills/ ← auto-detected by cd │ │
│ │ ├── api-conventions/ (local, committed to repo) │ │
│ │ └── deploy-guide/ (remote, in .gitignore) │ │
│ └─────────────────────────────┬─────────────────────────────┘ │
│ sync ↓ │ │
│ ┌────────────────────┼────────────────────┐ │
│ ▼ ▼ ▼ │
│ .claude/skills .cursor/skills .custom/skills │
│ (project-local) (project-local) (project-local) │
│ │
└─────────────────────────────────────────────────────────────────┘
Key Concepts
| Concept | What It Is | Learn More |
|---|---|---|
| Source & Targets | Single source of truth, multiple destinations | → Source & Targets |
| Sync Modes | Merge vs symlink — how files are linked | → Sync Modes |
| Tracked Repos | Git repos installed with --track |
→ Tracked Repositories |
| Skill Format | SKILL.md structure and metadata | → Skill Format |
| Project Skills | Project-level skills scoped to a repository | → Project Skills |
| Organization Skills | Organization-wide skills via tracked repositories | → Organization-Wide Skills |
Quick Summary
Source & Targets
- Source:
~/.config/skillshare/skills/— where you edit skills - Targets: AI CLI skill directories — where skills are deployed via symlinks
Sync Modes
- Merge (default): Each skill symlinked individually, local skills preserved
- Symlink: Entire directory is one symlink
Tracked Repos
- Git repos installed with
--track - Prefixed with
_(e.g.,_team-skills/) - Updated via
skillshare update <name>
Skill Format
SKILL.mdwith YAML frontmatter- Required:
namefield - Optional:
description, custom metadata
Project Skills
- Skills scoped to a single repository (
.skillshare/skills/) - Shared with team via git — auto-detected when
.skillshare/exists - Sync mode configurable per-target (merge default, symlink optional)
Organization Skills
- Shared across all projects via tracked repositories (
--track) - Install once, update with
skillshare update --all - Complements project skills — organization for standards, project for repo context