Skip to content

Settings and Repository Setup

Mr-GraphnStaff edited this page Nov 22, 2026 · 17 revisions

Connect and sync your repository

Delivery status — November 9, 2026: Stable 0.12.3 and preview 0.15.6 are published and publicly verified. Both include the guided repository connection repair.

Choose the three locations

Location Purpose Example
Workbench folder SkillJetty's editable drafts, built packages, background work and recovery C:/SkillJetty-Work
Local repository Your separate Git copy containing shared skills and ZIP files C:/Repositories/skills
Remote repository The GitHub destination paired with that local copy https://github.com/your-org/skills

Use distinct workbench and local repository roots. Preview 0.15.7 supports an existing local repository that contains a private workbench after checking that the workbench is untracked and Git-excluded. Stable 0.12.3 requires separate locations. Changing a connection preserves existing drafts and packages in place.

Connect or change a repository

  1. Open SkillJetty: Open Workbench. Choose the workbench location if one has not been selected.
  2. Choose Connect repository or Change connection in the project summary. You can also run SkillJetty: Connect or Change Repository from the Command Palette.
  3. Enter the GitHub repository URL, or your-org/skills. Use the repository address, not a tree/, blob/ or individual package URL.
  4. Choose Use an existing local repository and select its root containing .git, or Create a local copy and choose its parent folder. SkillJetty shows the exact new repository destination before cloning.
  5. Review the workbench folder, local repository and remote together, then confirm. Sign in to GitHub through VS Code if requested.

The GitHub repository must have an initial commit and readable default branch. No branch name needs to be entered manually.

SkillJetty verifies the local origin and complete pairing before activating it. An existing checkout is not pulled or rewritten during connection. A failed or canceled setup keeps the previous connection and drafts. Existing upload receipts retain their original repository identity.

Connect does not open generic Settings. The gear remains for advanced preferences. A guided connection is stored as one accepted local/remote pair; editing an old URL or path preference does not silently replace half that pair. Use Change connection to choose another destination.

Sync, edit and share separately

  • Sync repository explicitly downloads updates into the local copy. Local edits and conflicting files are preserved rather than overwritten.
  • Open skill from repository chooses a skill source from that copy. The folder must contain its own SKILL.md.
  • The build/share action prepares or uploads a package. Review and PR merge remain separate.
  • Saving a package locally needs no repository or GitHub account.

The summary shows the exact paths and destination. On a second computer, choose that computer's local folder; a home-PC path is not evidence of a work-PC setup.

GitHub account

Use the visible Connect GitHub account or Switch GitHub account action. VS Code manages authentication and repository-access consent. Canceling keeps the current draft. Do not put tokens or passwords into repository addresses.

Get started · Folder examples · Troubleshooting

Clone this wiki locally