What Are Skills?
Skills are Claude Code extensions that define workflows, guidelines, and tools. They’re written as Markdown files with YAML frontmatter and can include:- Code review checklists that Claude follows when reviewing PRs
- Deployment procedures with step-by-step instructions
- API design guidelines that Claude applies when writing endpoints
- Security audit workflows that trigger automatically when discussing vulnerabilities
- Anything else you want Claude to know or do consistently across your team
How It Works
Admin uploads a skill
Upload a skill package (
.tar.gz) in the dashboard under Rules Engine > Skills.Skill is encrypted and stored
The skill is encrypted with your organization’s key and stored securely.
Agents sync the skill
Within 15 minutes, every Turen agent downloads and deploys the skill to
~/.claude/skills/turen/.Creating a Skill
A skill is a.tar.gz archive containing a SKILL.md file with YAML frontmatter:
Frontmatter Options
| Field | Required | Description |
|---|---|---|
name | Yes | Skill identifier — becomes the /slash-command name |
description | Yes | When to use the skill. Claude uses this to decide when to auto-invoke. |
user-invocable | No | If true (default), appears in the / command menu |
disable-model-invocation | No | If true, only the developer can invoke it — Claude won’t auto-invoke |
allowed-tools | No | Restrict which tools Claude can use (e.g., Read, Grep, Glob) |
Supporting Files
Skills can include additional files alongsideSKILL.md. For example, a deployment skill might include a checklist:
SKILL.md can reference these files and Claude will have access to them.
Uploading a Skill
The skill is now queued for delivery. Agents will pick it up within 15 minutes.
Managing Skills
From Rules Engine > Skills, you can:- Enable/disable — Toggle whether a skill is delivered to agents
- Edit — Update the skill name, description, or upload new content
- Version history — View all previous versions with the ability to restore any version
- Delete — Remove a skill from all agent machines
Curated Skills
Turen provides a set of pre-built skills created by the Turen team. These cover common use cases and can be enabled with a single click. Curated skills appear in a separate tab from your custom skills.Versioning
Every time you upload or edit a skill, a new version is created. The dashboard shows the full version history with:- Version number
- Content hash
- File size
- Who made the change and when
- A Restore button to roll back to any previous version
What Developers See
Once a skill is deployed, developers see it natively in Claude Code: Manual invocation:Use Cases
Code Review Standards
Define what Claude should check during code reviews — security, performance, style, accessibility.
Deployment Procedures
Step-by-step checklists that Claude follows when helping with deployments.
API Design Guidelines
Enforce consistent API patterns, naming conventions, and error handling across your team.
Onboarding Guides
Help new developers navigate the codebase with context Claude can reference.
Security
- Skills are encrypted with your organization’s unique key (AES-256-GCM) before storage
- Only agents authenticated with your organization’s credentials can download skills
- Skills are written to a dedicated
~/.claude/skills/turen/directory — they cannot overwrite developer-created skills - All skill changes are logged in the audit trail