id          = "skillshare"
name        = "skillshare"
homepage    = "https://github.com/runkids/skillshare"
description = "One source of truth for AI CLI skills, agents, rules, commands & more. Sync everywhere with one command — from personal to organization-wide."
executables      = ["skillshare"]

[dotfiles]

# The project's README documents the global source directory as
# ~/.config/skillshare on macOS/Linux and %AppData%\\skillshare on Windows,
# with config.yaml plus skills/, agents/ and extras/ beneath it:
# https://github.com/runkids/skillshare#how-it-works
paths = [
  "~/.config/skillshare/config.yaml",
  "%APPDATA%/skillshare/config.yaml",
  "~/.config/skillshare/skills/",
  "%APPDATA%/skillshare/skills/",
  "~/.config/skillshare/agents/",
  "%APPDATA%/skillshare/agents/",
  "~/.config/skillshare/extras/",
  "%APPDATA%/skillshare/extras/",
]

secret  = []

[commands]
format = 1
label = "Skillshare"
description = "Sync, install, update and commit skills. Init, targets, audit, MCP, hooks, plugins and the dashboard are left out."
quality = "ai-draft"
parser = { end_of_options = "--", interleave = "permute", long_equals = true, short_attached = true, short_bundles = false }

[[commands.subcommand]]
path = ["sync"]
label = "Sync skills"
description = "Push the source skills to all configured targets."

[[commands.subcommand.source]]
id = "skillshare-readme"
kind = "manual"
url = "https://github.com/runkids/skillshare/blob/main/README.md"
revision = "v0.26.4 README"
evidence = '''skillshare sync            # Sync skills to all targets
skillshare sync --all             # sync skills + agents + extras + MCP + hooks together'''

[[commands.subcommand.field]]
id = "all"
label = "Sync everything (skills, agents, extras, MCP, hooks)"
type = "boolean"
option = ["--all"]
sources = ["skillshare-readme"]

[[commands.subcommand.task]]
id = "skills"
label = "Sync skills"
fields = ["all"]
required = []

[[commands.subcommand.task]]
id = "everything"
label = "Sync everything"
set = { all = [true] }
fields = ["all"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["all"]

[[commands.subcommand]]
path = ["update"]
label = "Update installed skills"
description = "Update installed skills from their sources."

[[commands.subcommand.source]]
id = "skillshare-readme"
kind = "manual"
url = "https://github.com/runkids/skillshare/blob/main/README.md"
revision = "v0.26.4 README"
evidence = '''skillshare update --all'''

[[commands.subcommand.field]]
id = "all"
label = "Update all"
type = "boolean"
option = ["--all"]
sources = ["skillshare-readme"]

[[commands.subcommand.task]]
id = "all"
label = "Update all"
set = { all = [true] }
fields = ["all"]
required = []

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["all"]

[[commands.subcommand]]
path = ["install"]
label = "Install skills"
description = "Install skills from a repository such as github.com/owner/skills."

[[commands.subcommand.source]]
id = "skillshare-readme"
kind = "manual"
url = "https://github.com/runkids/skillshare/blob/main/README.md"
revision = "v0.26.4 README"
evidence = '''skillshare install github.com/reponame/skills'''

[[commands.subcommand.field]]
id = "source"
label = "Source repository"
description = "For example github.com/owner/skills."
type = "string"
position = 0
min = 1
sources = ["skillshare-readme"]

[[commands.subcommand.task]]
id = "install"
label = "Install from a repository"
fields = ["source"]
required = ["source"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["source"]

[[commands.subcommand]]
path = ["commit"]
label = "Commit source changes"
description = "Commit changes in the skills source directory."

[[commands.subcommand.source]]
id = "skillshare-readme"
kind = "manual"
url = "https://github.com/runkids/skillshare/blob/main/README.md"
revision = "v0.26.4 README"
evidence = '''skillshare commit -m "Update review skill"
skillshare commit --dry-run'''

[[commands.subcommand.field]]
id = "message"
label = "Commit message"
type = "string"
option = ["-m"]
sources = ["skillshare-readme"]

[[commands.subcommand.field]]
id = "dry_run"
label = "Dry run"
type = "boolean"
option = ["--dry-run"]
sources = ["skillshare-readme"]

[[commands.subcommand.task]]
id = "commit"
label = "Commit with a message"
fields = ["message", "dry_run"]
required = ["message"]

[[commands.subcommand.group]]
id = "basic"
label = "Basic"
fields = ["message", "dry_run"]