Files
skillshare/website/docs/reference/appendix/url-formats.md
T
Willie 2c3003e04f feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 04:52:29 +08:00

4.4 KiB

sidebar_position
sidebar_position
4

URL Formats

All source URL patterns recognized by skillshare install.

Quick Reference

Format Example Notes
GitHub shorthand owner/repo Expands to github.com/owner/repo
GitHub with subdir owner/repo/path/to/skill Installs specific skill from repo
Full HTTPS https://github.com/owner/repo Any Git host
Full HTTPS with subdir https://github.com/owner/repo/path Subdir after host/owner/repo
SSH git@github.com:owner/repo.git Private repos via SSH key
SSH with subdir git@github.com:owner/repo.git//path // separates repo from subdir
GHE Cloud mycompany.github.com/org/repo Enterprise Cloud subdomain
GHE Server github.mycompany.com/org/repo Enterprise Server
Local path ~/my-skill or /abs/path Copies directory to source
Git file URL file:///path/to/repo Local git clone (for testing)

GitHub Shorthand

The simplest format — just owner/repo:

skillshare install anthropics/skills
skillshare install ComposioHQ/awesome-claude-skills

This expands to https://github.com/owner/repo internally.

With Subdirectory

Add a path after owner/repo to install a specific skill:

skillshare install anthropics/skills/skills/pdf
skillshare install anthropics/skills/skills/commit

When the subdir doesn't match exactly, skillshare scans the repo for a skill with that basename:

# "pdf" doesn't exist at root, but found at skills/pdf/ — resolves automatically
skillshare install anthropics/skills/pdf

Full HTTPS URLs

Works with any Git host:

# GitHub
skillshare install https://github.com/owner/repo

# GitLab
skillshare install https://gitlab.com/owner/repo

# Bitbucket
skillshare install https://bitbucket.org/owner/repo

# Self-hosted Gitea
skillshare install https://git.mycompany.com/team/skills

SSH URLs

Use SSH for private repositories:

# Standard SSH
skillshare install git@github.com:owner/repo.git

# With subdirectory (note the // separator)
skillshare install git@github.com:owner/repo.git//path/to/skill

# GitLab SSH
skillshare install git@gitlab.com:owner/repo.git

:::info The // separator For SSH URLs, use // to separate the repo from the subdirectory path. This is because the : in SSH URLs already serves as a separator, so the standard / path convention would be ambiguous. :::

GitHub Enterprise

Enterprise hostnames are recognized automatically:

# Enterprise Cloud (subdomain pattern: *.github.com)
skillshare install mycompany.github.com/org/repo

# Enterprise Server (hostname pattern: github.*.*)
skillshare install github.mycompany.com/org/repo
skillshare install github.internal.corp/team/skills

Both patterns support subdirectory paths:

skillshare install github.mycompany.com/org/repo/path/to/skill

Local Paths

Install from a directory on your filesystem:

# Absolute path
skillshare install /home/user/my-skill

# Home directory shorthand
skillshare install ~/my-skill

# Relative path
skillshare install ./local-skill

Local installs copy files (not symlink) and are not updatable via skillshare update.

Authentication

# Ensure your SSH key is loaded
ssh-add ~/.ssh/id_ed25519

# Install via SSH
skillshare install git@github.com:company/private-skills.git

HTTPS with Tokens

For HTTPS URLs, git uses your configured credential helper:

# Configure git credential helper (one-time)
git config --global credential.helper store

# Or use GH CLI for GitHub
gh auth login

# Then install normally
skillshare install https://github.com/company/private-repo

:::tip Private Repos If you get an authentication error with HTTPS, switch to SSH URLs. skillshare sets GIT_TERMINAL_PROMPT=0 to prevent hanging credential prompts, so interactive HTTPS auth won't work. :::

Platform Support

Feature GitHub GitLab Bitbucket Gitea GHE
Shorthand (owner/repo) Yes No No No Yes
Full HTTPS URL Yes Yes Yes Yes Yes
SSH URL Yes Yes Yes Yes Yes
Subdirectory Yes Yes Yes Yes Yes
skillshare search Yes No No No No