Team Collaboration

SkillKit provides powerful team collaboration features to ensure every developer has the same AI agent capabilities, follows the same patterns, and stays in sync.

Quick Start

# Initialize team manifest
skillkit team init

# Add skills to team manifest
skillkit team add anthropics/skills
skillkit team add ./local-skills

# Share with team (commit to Git)
git add .skills
git commit -m "Add team skills manifest"
git push

# Team members install
git pull
skillkit team install

Team Manifest (.skills)

The .skills file is a Git-committable manifest that defines your team's skill stack.

Example Manifest

{
  "version": "1.0",
  "name": "my-team",
  "skills": [
    {
      "source": "anthropics/skills",
      "skills": ["pdf", "xlsx", "docx"],
      "version": "1.2.0"
    },
    {
      "source": "vercel-labs/agent-skills",
      "skills": ["react-best-practices", "nextjs-patterns"],
      "version": "latest"
    },
    {
      "source": "./local-skills",
      "skills": ["company-coding-standards", "api-guidelines"],
      "type": "local"
    }
  ],
  "agents": ["claude", "cursor", "windsurf"],
  "config": {
    "autoSync": true,
    "syncOnPull": true
  }
}

Commands

Initialize Team

# Create .skills manifest
skillkit team init

# Specify team name
skillkit team init --name engineering-team

# Add initial skills
skillkit team init --skills anthropics/skills,vercel-labs/agent-skills

Manage Skills

# Add skill source
skillkit team add anthropics/skills

# Add specific skills
skillkit team add anthropics/skills --skills pdf,xlsx

# Remove skill
skillkit team remove anthropics/skills

# List team skills
skillkit team list

Install & Sync

# Install all team skills
skillkit team install

# Install and sync
skillkit team install --sync

# Force reinstall
skillkit team install --force

# Share current skills as team manifest
skillkit team share

# Update team manifest from installed skills
skillkit team update

# Sync team manifest with Git remote
skillkit team sync

Git Integration

Auto-Install on Pull

Add to .git/hooks/post-merge:

#!/bin/sh
if [ -f .skills ]; then
  echo "📦 Installing team skills..."
  skillkit team install --yes
fi

Make it executable:

chmod +x .git/hooks/post-merge

Pre-Commit Validation

Ensure skills are valid before committing:

# .git/hooks/pre-commit
#!/bin/sh
if [ -f .skills ]; then
  echo "🔍 Validating team skills..."
  skillkit team validate
  if [ $? -ne 0 ]; then
    echo "❌ Team skills validation failed"
    exit 1
  fi
fi

CI/CD Integration

GitHub Actions

# .github/workflows/skills.yml
name: Team Skills

on:
  pull_request:
    paths:
      - '.skills'

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup Node
        uses: actions/setup-node@v3
        with:
          node-version: '18'
      
      - name: Install SkillKit
        run: npm install -g skillkit
      
      - name: Validate Team Manifest
        run: skillkit team validate
      
      - name: Install Skills
        run: skillkit team install --yes
      
      - name: Run Skill Tests
        run: skillkit test

GitLab CI

# .gitlab-ci.yml
skills:validate:
  stage: test
  script:
    - npm install -g skillkit
    - skillkit team validate
    - skillkit team install --yes
    - skillkit test
  only:
    changes:
      - .skills

Private Registries

Host proprietary skills in private repositories.

Setup Private Registry

# Add private registry
skillkit registry add company-skills \
  --url https://github.com/mycompany/skills \
  --token $GITHUB_TOKEN

# Install from private registry
skillkit install company-skills/auth-patterns

Team Manifest with Private Skills

{
  "skills": [
    {
      "source": "company-skills/proprietary-skills",
      "registry": "company-skills",
      "skills": ["auth-patterns", "payment-processing"],
      "private": true
    }
  ],
  "registries": [
    {
      "name": "company-skills",
      "url": "https://github.com/mycompany/skills",
      "auth": "env:GITHUB_TOKEN"
    }
  ]
}

Team Workflows

Onboarding New Developers

# 1. Clone repository
git clone https://github.com/company/project
cd project

# 2. Install team skills
skillkit team install

# 3. Generate project instructions
skillkit primer --all-agents

# 4. Sync to agents
skillkit sync

# ✅ Developer is ready!

Creating Team-Wide Skills

# 1. Create new skill
skillkit create company-coding-standards

# 2. Add to local skills
mv company-coding-standards ./local-skills/

# 3. Add to team manifest
skillkit team add ./local-skills

# 4. Commit and push
git add .skills local-skills/
git commit -m "Add company coding standards"
git push

Updating Team Skills

# 1. Update skill version
skillkit team update anthropics/skills --version 1.3.0

# 2. Test locally
skillkit team install
skillkit test

# 3. Commit if tests pass
git add .skills
git commit -m "Update anthropics/skills to v1.3.0"
git push

Best Practices

Version Pinning

Pin critical skills to specific versions:

{
  "skills": [
    {
      "source": "anthropics/skills",
      "version": "1.2.0",
      "pinned": true
    }
  ]
}

Skill Categories

Organize by category:

{
  "skills": [
    {
      "category": "core",
      "source": "anthropics/skills",
      "required": true
    },
    {
      "category": "optional",
      "source": "vercel-labs/agent-skills",
      "required": false
    }
  ]
}

Environment-Specific Skills

{
  "environments": {
    "development": {
      "skills": ["debug-tools", "dev-server-patterns"]
    },
    "production": {
      "skills": ["performance-monitoring", "error-tracking"]
    }
  }
}

Conflict Resolution

Skill Name Conflicts

When multiple sources provide the same skill name:

# List conflicts
skillkit team conflicts

# Resolve by priority
skillkit team resolve --priority "local,anthropics,vercel"

Version Conflicts

# Show version mismatches
skillkit team check-versions

# Align to latest
skillkit team align --strategy latest

# Align to pinned
skillkit team align --strategy pinned

Programmatic API

import { TeamManifest, TeamSync } from '@skillkit/core'

// Load team manifest
const manifest = await TeamManifest.load('./.skills')

// Install team skills
const sync = new TeamSync(manifest)
await sync.install({
  agents: ['claude', 'cursor'],
  force: false,
})

// Update manifest
manifest.addSkill({
  source: 'anthropics/skills',
  skills: ['pdf'],
  version: '1.2.0',
})

await manifest.save()

Troubleshooting

Skills Not Syncing

# Force reinstall
skillkit team install --force

# Clear cache
skillkit team clean

# Reinstall
skillkit team install

Manifest Validation Errors

# Validate manifest
skillkit team validate --verbose

# Fix common issues
skillkit team validate --fix

Merge Conflicts in .skills

# Accept theirs
git checkout --theirs .skills
skillkit team install

# Accept ours
git checkout --ours .skills
skillkit team install

# Merge manually
skillkit team merge-conflicts

Next Steps

CI/CD Integration - Automate skill deployment
Workflows - Team-wide automation
Testing - Validate skills before deployment

Team Collaboration

On this page