mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
* 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.
3.1 KiB
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 |