Files
Willie 0511c57b97 docs(how-to): add guide for machines on a private network (#962)
* docs(how-to): add guide for machines on a private network

Users who already connect their machines with Tailscale, WireGuard, or
a home network plus SSH can use skillshare across them without GitHub,
but no page said so. Each piece already works: init --remote accepts
any Git URL, the dashboard answers on an IP address or a trusted name,
and mcp serve --http takes a bearer token on a private network.

The new page covers a bare repository on one machine as the remote,
opening another machine's dashboard through an SSH tunnel or its
private address, and serving skills to agents on another machine. It
also documents two traps found while running the flow end to end: a
new bare repository's HEAD names master, so the next machine's init
silently clones nothing until HEAD points at the pushed branch; and
init --remote on a configured machine keeps the old remote.

Translated for ja, ko, zh-Hans, and zh-Hant, with links from the
cross-machine guide, its recipe, the ui reference, and the how-to index.

* fix(how-to): point remote set-url at the skills repository

The private-network guide told users with an existing remote to run
git -C ~/.config/skillshare remote set-url. A setup made with plain
init and connected to a remote later keeps its repository in the skills
folder (git_root defaults to skills), so that command fails with "not a
git repository" and the old remote stays. Checked in a container: after
init then init --remote, .git is in ~/.config/skillshare/skills and
init itself prints the skills path.

The guide now says to run the command init prints, with
~/.config/skillshare/skills as the example. That path also works when
the repository is at ~/.config/skillshare (a fresh init --remote), since
git finds the parent repository. Fixed in the English page and the ja,
ko, zh-Hans, and zh-Hant copies.
2026-11-19 13:25:30 +08:00

3.1 KiB

sidebar_position
sidebar_position
1

How-To Guides

Practical guides for specific tasks and use cases.

What do you want to do?

I want to... Read
Write my first skill Creating Skills
Design reliable, deterministic skills Skill Design
Organize a growing skill collection Organizing Skills
Share skills with my team via a git repo Organization-Wide Skills
Set up skills for a specific project Project Setup
Sync skills across multiple machines Cross-Machine Sync
Sync without GitHub, or manage another machine over SSH or Tailscale Machines on a Private Network
Browse and discover community skills Hub Index
Secure my skill supply chain Securing Your Skills
Move from another tool or approach Migration
Test skillshare in an isolated Docker sandbox Docker Sandbox

By Topic

Daily Tasks

Guide Description
Creating Skills Create and publish your own skills
Organizing Skills Organize skills into folders with auto-flattening
Best Practices Naming, organization, and versioning
Daily Workflow Day-to-day skill management workflow
Skill Discovery Find and evaluate skills
Backup & Restore Back up and restore your skills
Project Workflow Project-level skill workflow

Sharing & Teams

Guide Description
Project Setup Set up project-scoped skills for a repo
Organization-Wide Skills Share skills across your organization
Cross-Machine Sync Sync skills across computers
Machines on a Private Network No hosted Git, another machine's dashboard, skills over MCP
Hub Index Browse and manage skill hubs

Advanced

Guide Description
Migration Migrate from other tools or between modes
Local-First Local-first architecture details
Docker Sandbox Isolated test sandbox and interactive playground
Securing Your Skills Security scanning, custom rules, and organizational policy