Files
skillshare/website/docs/reference/commands/commit.md
T
Willie cf36965cea feat(website): add zh-Hant/zh-Hans/ja/ko locales with initial docs translation
Sets up Docusaurus i18n for Traditional Chinese, Simplified Chinese,
Japanese, and Korean: locale config, navbar/footer/sidebar UI chrome,
and translated content for intro, getting-started, understand, and
reference/commands. Untranslated pages fall back to English.

Pins explicit heading anchors ({#id}) on English source pages that are
linked to by fragment, so translated headings don't change the anchor
id and break cross-page links. Converts a handful of relative .md
links that crossed from an untranslated page into a now-translated
one, since Docusaurus resolves those per-locale and they'd otherwise
404 outside English.
2026-09-20 11:08:48 +08:00

2.6 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