Files
skillshare/website/docs/reference/commands/commit.md
T
Willie 9fb7b1eca4 docs(git-root): clarify how to change scope after init; fix misleading mismatch guidance
The mismatch guidance told users to re-run 'skillshare init', but init warns
and ignores --git-root once a repo already exists, so it never relocates the
repo. Reword the CLI message to state the real options: run 'git init' at the
new scope dir for a fresh history, or 'mv <old>/.git <new>/.git' to keep
history, or set git_root to match the existing repo.

Add a 'Changing the scope after init' section to the git_root config reference
and point the commit/push/pull pages at it, replacing the same misleading
're-run init' phrasing.
2026-05-30 19:23:12 +08:00

2.5 KiB

sidebar_position
sidebar_position
1

commit

Create a local git commit for source skills without pushing.

skillshare commit                         # Commit with default message
skillshare commit -m "Update skill"       # Custom message
skillshare commit --dry-run               # Preview

When to Use

  • Save a local checkpoint before experimenting with skill edits
  • Commit changes on a machine or source repo that does not have a remote configured
  • Keep local history separate from sharing changes across machines

Use push when you want to commit and push to a git remote.

What Happens

flowchart TD
    CMD["skillshare commit"]
    CHECK["1. Check repository status"]
    STAGE["2. Stage all changes"]
    COMMIT["3. Commit"]
    CMD --> CHECK --> STAGE --> COMMIT

commit stages all changes in the skills source directory and creates a git commit. It does not require a remote and never runs git push.

Options

Flag Description
-m, --message <msg> Commit message (default: "Update skills")
--dry-run, -n Preview without making changes

Git Root Scope

commit operates on the directory selected by the git_root config field (default: skills source). Use skillshare init --git-root <scope> to change which directory is versioned. Valid scopes:

Scope Directory
skills (default) Skills source (~/.config/skillshare/skills/)
agents Agents source (~/.config/skillshare/agents/)
extras Extras source (~/.config/skillshare/extras/)
root Config root (~/.config/skillshare/) — versions skills + agents + extras in one repo

If git_root was changed but the git repo still lives in another scope's directory, commit prints a "Git root mismatch" error with the exact git init / mv commands to fix it. See Changing the scope after init.

Prerequisites

Your skills source directory must be a git repository:

skillshare init

If the source is not a git repository, commit prints a setup hint and exits without changing files.

Examples

# Commit with the default message
skillshare commit

# Commit with a custom message
skillshare commit -m "Update review skill"

# Preview staged files and message without committing
skillshare commit --dry-run

See Also

  • push — Commit and push to a git remote
  • pull — Pull from remote and sync to targets
  • status — Check git and sync state