github runkids/skillshare v0.9.0

latest releases: v0.18.4, v0.18.3, v0.18.2...
one month ago

v0.9.0

✨ Project-Level Skills

Scope skills to a single repository — shared with your team via git.

The biggest feature in this release: skillshare now supports project mode. Instead of managing skills globally in ~/.config/skillshare/, you can manage them per-project in .skillshare/ — committed directly to your repo.

How It Works

<project-root>/
├── .skillshare/
│   ├── config.yaml              # Targets + remote skills list
│   ├── .gitignore               # Ignores cloned remote/tracked skill dirs
│   └── skills/
│       ├── my-skill/            # Local skill
│       └── _team-repo/          # Tracked repo (--track)
├── .claude/skills/              # ← symlinked from .skillshare/skills/
└── .cursor/skills/              # ← symlinked from .skillshare/skills/

Quick Start

# Initialize project-level skills
skillshare init -p

# Create or install skills
skillshare new my-skill -p
skillshare install anthropics/skills/skills/pdf -p

# Sync to targets
skillshare sync

Key Features

  • Project-scoped — Skills live in .skillshare/skills/, committed to the project repo
  • Auto-detection — Commands auto-detect project mode when .skillshare/config.yaml exists (no -p flag needed)
  • Force flags — Use -p (project) or -g (global) to override auto-detection
  • Team onboarding — New members just run skillshare install -p && skillshare sync
  • Coexists with global — Project and global skills work independently
  • Tracked reposskillshare install --track -p works in project mode, auto-added to .gitignore

All Commands Support Project Mode

Command Project Mode Notes
init -p Creates .skillshare/ with config, gitignore, and skills directory
sync Auto-detects project mode
install -p Install remote skills to project source
uninstall -p Remove skills from project source
update -p Update remote/tracked skills
list Auto-detects project mode
status Auto-detects project mode
target add/remove/list -p Manage project targets
collect Collect local skills from project targets
push / pull Not needed — use git directly
backup / restore Not needed — project targets are reproducible

🔍 Search with Project Mode

skillshare search now supports --project / -p and --global / -g flags. When you find a skill interactively, it installs directly to .skillshare/skills/ — no separate install -p step needed.

skillshare search pdf -p          # Search → select → install to project
skillshare search react --global  # Force global install
  • Auto-detects project mode when .skillshare/config.yaml exists
  • Auto-runs init -p if the project hasn't been initialized yet
  • Updates .skillshare/config.yaml and .gitignore automatically

🎯 Per-Target Sync Mode (Project Mode)

Project targets can now set sync mode individually — merge (default) or symlink — matching the global mode behavior.

# .skillshare/config.yaml
targets:
  - claude-code                    # merge (default)
  - name: cursor
    mode: symlink                  # symlink for this target only
  - name: custom-ide
    path: ./tools/ide/skills
    mode: merge

Features

  • Per-target mode field in config.yaml with YAML marshal/unmarshal
  • skillshare target <name> --mode symlink -p to change mode
  • Mode-aware target remove (proper cleanup for both modes)
  • Unified sync UI output format between project and global modes

🔧 Internal

  • New mode.go handles -p / -g flag parsing and auto-detection logic
  • New project_runtime.go for project config loading
  • Extracted internal/config/targets.go with targets.yaml for known target definitions
  • internal/config/project.go for project-specific config types (ProjectTargetEntry with Mode field)
  • Comprehensive integration test coverage for all project-mode commands

📖 Documentation

  • New concept page: Project Skills
  • New guide: Project Setup
  • New workflow: Project Workflow
  • Updated all command docs with project-mode sections (init, install, list, status, sync, target, uninstall, update)
  • Updated README with Project Skills section

Changelog

  • 010b707 chore(docs): update docs
  • 1bbfb66 chore: update website links to new domain
  • 7e8cab2 docs(skill): improve built-in skillshare skill v0.8.2
  • 46d1ee5 docs(skill): update built-in skill to v0.9.0 with project mode support
  • 4b914b0 docs(website): add Docusaurus docs synced from docs/
  • 9cef926 docs(website): refactor docs
  • 087ac0b feat(website): add SEO essentials - sitemap, robots.txt, social card
  • 0162bdd feat: add per-target sync mode support for project mode
  • b83300a feat: project level skills
  • 671ea97 fix(install.sh): use redirect to avoid API rate limit
  • 6cba953 fix(website): responsive footer padding and README link corrections
  • 6650a8c style: fix docs formatting

Full Changelog: v0.8.1...v0.9.0

Don't miss a new skillshare release

NewReleases is sending notifications on new releases.