How to Share Agent Skills with Your Team [Workflow Standardization Tips]

A major advantage of Agent Skills is that they can be shared with teams.

Problems like "everyone writes PRs differently" or "code review criteria vary by person" can be standardized with skills.

This article explains how to share and manage skills across a team.

Sharing Options

Option 1: Include in Project Repository

The simplest approach. Place skills in the project's .claude/skills/ and version control with code.

Copyyour-project/
├── src/
├── .claude/
│   └── skills/
│       ├── code-review/
│       │   └── SKILL.md
│       └── pr-template/
│           └── SKILL.md
└── package.json

Pros:

• No setup required. Clone and use
• Syncs with project changes
• Skills get code reviewed too

Cons:

• Project-specific skills only
• Need another method for cross-project sharing

Option 2: Create a Dedicated Skills Repository

Manage team-wide skills in a separate repository.

Copyteam-skills/
├── code-review/
│   └── SKILL.md
├── pr-template/
│   └── SKILL.md
├── security-check/
│   └── SKILL.md
└── README.md

Each member clones to ~/.claude/skills/:

Copygit clone git@github.com:your-org/team-skills.git ~/.claude/skills/team

Pros:

• Use common skills across all projects
• Centralized skill updates

Cons:

• Each member needs setup
• Updates require git pull

Option 3: Manage with Git Submodules

Add the skills repository as a submodule.

Copygit submodule add git@github.com:your-org/team-skills.git .claude/skills/team

Pros:

• Link project and skill versions
• Get skills with clone (--recursive option)

Cons:

• Requires submodule familiarity

Team Operation Best Practices

Write Comprehensive READMEs

Copy# code-review

Skill for reviewing PR code.

## Usage

/code-review

Copy
Or ask naturally: "Review this PR"

## Review Criteria

- Security
- Performance
- Maintainability
- Test coverage

## Changelog

- 2026-01-24: Initial version
- 2026-01-20: Added TypeScript-specific checks

Use PRs for Changes

Change skills via PRs and team review, just like code.

Copygit checkout -b update-code-review-skill
# Edit SKILL.md
git commit -m "feat: add a11y check to code-review skill"
git push origin update-code-review-skill
# Create PR

Include Version Info

Adding version info to SKILL.md helps troubleshooting.

Copy---
name: code-review
description: Review PR code
version: 1.2.0
---

Create Onboarding Docs

Document skill setup for new team members.

Copy# Development Environment Setup

## 1. Install Team Skills

```bash
git clone git@github.com:your-org/team-skills.git ~/.claude/skills/team

2. Verify Skills

Run /skills in Claude Code and confirm these appear:

• team/code-review
• team/pr-template
• team/security-check

Copy
## Common Challenges and Solutions

### Challenge: Different Skill Versions Across Team

**Solutions**:
- Establish regular `git pull` rules
- Notify skill updates via Slack
- CI checks for skill versions (advanced)

### Challenge: Too Many Skills to Manage

**Solutions**:
- Periodically audit unused skills
- Organize by category directories
- Classify required vs optional skills

team-skills/ ├── core/ # Required for everyone │ ├── code-review/ │ └── pr-template/ ├── frontend/ # Frontend team │ └── component-review/ └── backend/ # Backend team └── api-review/

Copy
### Challenge: Inconsistent Skill Quality

**Solutions**:
- Create skill authoring guidelines
- Require PR reviews
- Provide templates

## Leveraging Claude Cowork

Released in January 2026, Claude Cowork makes team skill management easier.

- Manage skills at team level
- Permission settings to restrict editors
- Usage analytics

Details coming in a future article.

## Summary

Sharing Agent Skills across teams standardizes workflows.

1. **Small teams**: Include in project repository
2. **Multiple projects**: Create dedicated skills repository
3. **Strict management**: Use Git submodules

Start with one skill and expand based on team feedback.

Browse the [Skills list](/skills) for team-friendly skills.

## Related Articles

- [How to Create Your Own Skills](/blog/how-to-create-custom-skill) - Create original skills
- [Skill Security Best Practices](/blog/skill-security-best-practices) - Use safely with teams
- [Migrating from CLAUDE.md](/blog/migrating-from-claude-md) - Convert existing config
- [7 Tips for Better Productivity](/blog/agent-skills-productivity-tips) - Team usage tips