Files
skillshare/website/docs/concepts/index.md
T
2026-02-05 14:15:05 +08:00

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.md with YAML frontmatter
  • Required: name field
  • 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