---

``bash
npm install -g tskills

tskills login # Authenticate with GitHub
tskills search "deploy" # Find skills
tskills install acme/skill # Install to all your AI tools
`

Why?

- Share team knowledge — publish proprietary skills to your organization, not a public marketplace
- Works everywhere — one install syncs to Claude Code, Cursor, Copilot, and Windsurf
- Versioned & managed — semantic versioning, updates, deprecation, just like npm

---

Quick Start

$3

`bash
npm install -g tskills
tskills login
`

$3

`bash


Search for skills

tskills search "code review"

Install a skill (syncs to all your AI tools automatically)

tskills install acme/deploy-checklist

Install a specific version

tskills install acme/deploy-checklist@1.2.0
`

$3

Create a SKILL.md with YAML frontmatter:

`markdown
---
name: code-review
description: Reviews code for our team's standards
tools: [claude, cursor]
tags: [code-review, best-practices]
---

Code Review Guidelines

When reviewing code, check for:
- Our naming conventions
- Error handling patterns
- Test coverage requirements
`

Then publish:

`bash
tskills publish ./SKILL.md
`

$3

`bash
tskills outdated # Check for updates
tskills update # Update all skills
`

---

Registry Commands

| Command | Description |
|---------|-------------|
| tskills login | Authenticate via GitHub |
| tskills logout | Sign out |
| tskills whoami | Show current user |
| tskills publish | Publish skill to registry |
| tskills install | Install from registry |
| tskills uninstall | Remove a skill |
| tskills search [query] | Search for skills |
| tskills info | View skill details |
| tskills outdated | Check for updates |
| tskills update [owner/name] | Update installed skills |
| tskills deprecate | Mark skill as deprecated |

$3

| Command | Description |
|---------|-------------|
| tskills org create | Create an organization |
| tskills org list | List your organizations |
| tskills org info | View organization details |
| tskills org add | Add member to organization |
| tskills org remove | Remove member |
| tskills org delete | Delete organization |
| tskills team create / | Create a team |
| tskills team list | List teams in organization |
| tskills team info / | View team details |
| tskills team add / | Add member to team |
| tskills team remove / | Remove member |
| tskills team delete / | Delete team |

Share private skills within your company:

`bash


Create an organization

tskills org create acme --name "Acme Corp"

Add team members

tskills org add acme @colleague

Publish org-private skill

tskills publish ./SKILL.md --org acme --visibility org

Publish team-restricted skill

tskills publish ./SKILL.md --org acme --team engineering --visibility team
`

$3

| Visibility | Who can access |
|------------|----------------|
| public | Anyone (default) |
| private | Only you |
| org | All members of your organization |
| team | Only members of a specific team |

---

Git-Based Sync (Legacy)

tskills also supports syncing skills from a private Git repository — useful if you prefer managing skills in a repo rather than the registry.

| Command | Description |
|---------|-------------|
| tskills setup | Create GitHub repo + configure |
| tskills init | Initialize a skills repo locally |
| tskills add | Create a new skill from template |
| tskills import | Import existing SKILL.md files |
| tskills list | List available skills |
| tskills sync | Pull from remote and sync to tools |
| tskills share | Get shareable setup command |
| tskills invite | Add GitHub collaborator |
| tskills config | View/edit configuration |

`bash
npx tskills setup --name my-team-skills # Create repo
npx tskills sync # Sync to tools
`

> Tip: ts is a built-in alias for tskills

---

Where Skills Are Synced

| Tool | User Scope | Project Scope |
|------|------------|---------------|
| Claude Code | ~/.claude/skills/ | ./.claude/skills/ |
| GitHub Copilot | ~/.claude/skills/ | ./.claude/skills/ |
| Cursor | ~/.cursor/rules/ | ./.cursor/rules/ |
| Windsurf | ~/.windsurfrules | ./.windsurfrules |

Configuration

Config is stored in ~/.tskills/config.toml:

`toml
[remote]
url = "https://github.com/your-org/team-skills.git"
branch = "main"

[defaults]
scope = "user"

[tools]
claude = true
cursor = true
copilot = true
windsurf = false
`

Edit with:

`bash
tskills config --repo # Set remote repo
tskills config --default-scope user # Set default scope
tskills config --cursor false # Disable Cursor sync
tskills config --show # View current config
`

Requirements

- Node.js 18+
- GitHub account — for registry authentication
- GitHub CLI (gh) — only needed for legacy setup, share, and invite commands
- Install: https://cli.github.com
- Authenticate: gh auth login`

Documentation

- Registry User Guide — complete guide to using the registry
- CLI Reference — all commands and options
- Troubleshooting — common issues and solutions

Contributing

Contributions are welcome! Please read our Contributing Guidelines first.

License

MIT