Skills for Fleet-wide Deployment
Benchmarked against: Anthropic — Skills for enterprise Scope: Deploying skills across SS1, SS2, SS3
When a skill proves valuable on one ship, it should be available fleet-wide. This page covers how to deploy, version, and maintain skills across the fleet.
Deployment model
Skills live in the Git repository under .claude/skills/. Since all ships share the same repo, skills deploy automatically via git pull.
No separate deployment pipeline needed
| Step | How |
|---|---|
| Create skill | .claude/skills/name/prompt.md |
| Test locally | Invoke on SS1, verify |
| Deploy | git commit + git push |
| Fleet access | Other ships git pull |
Ship-specific vs. fleet-wide skills
| Type | Location | Available to |
|---|---|---|
| Fleet-wide | .claude/skills/ (in repo) | All ships |
| Ship-specific | Outside repo, local only | Single ship |
Recommendation: All skills should be fleet-wide unless they depend on ship-specific hardware or local services.
Skill compatibility across ships
| Concern | Check |
|---|---|
| MCP server references | All referenced MCP servers available on target ship? |
| File path references | Paths portable across OS? (macOS vs Windows) |
| Engine references | All referenced engines configured on target ship? |
| Tool references | All referenced tools available? |
Example: SS1 vs SS2 compatibility
| Feature | SS1 (Mac) | SS2 (Windows) |
|---|---|---|
Python .venv path | /Users/.../ | C:\Users\...\ |
| Shell commands | bash | cmd / powershell |
| Chrome MCP | Available | Available |
| Local UBI | Available | Available (after setup) |
| Cloud UB | Available | Available |
Versioning skills
Skills should follow these versioning practices:
| Practice | Why |
|---|---|
| Version header in prompt.md | Track which version is deployed |
| Relative time expressions | "current version" not "v1.2.3" |
| Changelog in UB | Ingest skill changes as decisions |
# Skill Name
> Version: 2.0 (Updated 2026-03-05)
> Previous: 1.0 (Initial version)
Onboarding new skills to agents
When a new skill is deployed, agents need to know it exists. The skills list in Claude Code auto-discovers from .claude/skills/, so new skills appear automatically.
No manual registration needed — the system discovers skills by directory presence.
Related pages
| Page | Relationship |
|---|---|
| Skills Overview | What skills are |
| Creating a Skill | How to build |
| Fleet Management | Fleet operations |