skill-name · claude-office-skills — Claude Code skill: office skill template
A template skill from the Claude Office Skills set: it lays out the metadata and section structure for skills that handle documents and legal work.
npx skills add claude-office-skills/skills --skill skill-name -a claude-code
npx skills add claude-office-skills/skills --skill _template -a claude-codeWhat skill-name does
This is a starting point, not a working skill. The SKILL.md file opens with an extended metadata header: name, description, version, MIT license, category, tags, department. Then come model compatibility, a link to the office-mcp server with tools such as extract_text_from_pdf and extract_text_from_docx, input and output specs, capabilities and related skills.
The body is split into sections: an overview of what the skill can and cannot do, step-by-step usage, domain knowledge, output format, examples, tips and limitations. The header sets category legal, tags contract, review, risk-analysis, and department Legal. English and Chinese are the listed languages.
Copying the template as-is gets you nothing useful — the description stays a placeholder and the sections stay in square brackets. That is the cue to rewrite the header and fill domain knowledge with your own rules right away. Out of the box it analyses nothing; the actual document work comes from office-mcp tools, which you wire up separately.
What it helps with
- lay out skill metadata across required and optional fields
- describe input files and text parameters before writing any logic
- wire the skill to the right MCP server tools
- set up a report structure with risks, findings and recommendations
- check related skills in the same category to avoid overlap
Example prompts for the agent
- Take
_template/SKILL.mdand fill the header for a contract review skill - Add rules for the
legalcategory to the domain knowledge section - Describe the
party_roleinput and a markdown output format in the template
How to install skill-name
1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill skill-name -a claude-codenpx skills add claude-office-skills/skills --skill _template -a claude-code2Manually: put the files in place
~/.claude/skills/_template/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/_template/
1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill _template -a codex2Manually: put the files in place
.agents/skills/_template/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill _template -a cursor2Manually: put the files in place
.cursor/skills/_template/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install claude-office-skills/skills _template2Manually: put the files in place
.github/skills/_template/SKILL.md1Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill _template -a gemini-cli2Platform CLI
gemini skills install https://github.com/claude-office-skills/skills --path _templateManually: put the files in place
.devin/skills/_template/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add claude-office-skills/skills --skill _template -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about skill-name
How do I install skill-name in Claude?
Run npx skills add claude-office-skills/skills --skill skill-name -a claude-code. Or install the template itself with npx skills add claude-office-skills/skills --skill _template -a claude-code, which puts the file at ~/.claude/skills/_template/SKILL.md.
What does skill-name do?
It defines a skill's structure: metadata, model compatibility, the office-mcp binding, input and output specs, plus sections for domain knowledge and examples.
Which models does the template support?
The header recommends claude-sonnet-4 and claude-opus-4, and lists claude-3-5-sonnet, gpt-4 and gpt-4o as compatible.
Source text
SKILL.md · MIT
---
# ═══════════════════════════════════════════════════════════════════════════════
# CLAUDE OFFICE SKILL - Enhanced Metadata Template v2.0
# ═══════════════════════════════════════════════════════════════════════════════
#
# This template defines a Skill as a "Scenario-based Solution Guide"
# Skills tell AI "WHAT" to do and "HOW" to do it
# MCP tools provide "WITH WHAT" to accomplish tasks
#
# ═══════════════════════════════════════════════════════════════════════════════
# ─────────────────────────────────────────────────────────────────────────────────
# BASIC INFORMATION (Required)
# ─────────────────────────────────────────────────────────────────────────────────
name: skill-name
description: >
A clear, concise description of what this skill does (1-2 sentences).
Focus on the VALUE it provides to the user.
version: 1.0.0
author: claude-office-skills
license: MIT
# ─────────────────────────────────────────────────────────────────────────────────
# CATEGORIZATION (Required)
# ─────────────────────────────────────────────────────────────────────────────────
category: legal # Primary category: legal | hr | finance | sales | marketing | productivity | pdf | document | spreadsheet | presentation | workflow
tags:
- contract # Domain tags
- review # Action tags
- risk-analysis # Feature tags
department: Legal # Target department/user group
# ─────────────────────────────────────────────────────────────────────────────────
# AI MODEL COMPATIBILITY (Optional)
# ─────────────────────────────────────────────────────────────────────────────────
models:
recommended:
- claude-sonnet-4
- claude-opus-4
compatible:
- claude-3-5-sonnet
- gpt-4
- gpt-4o
# ─────────────────────────────────────────────────────────────────────────────────
# MCP TOOLS INTEGRATION (Required for tool-using skills)
# ─────────────────────────────────────────────────────────────────────────────────
# Skills are "solution guides" - MCP provides the actual tools
mcp:
server: office-mcp # Which MCP server provides the tools
tools: # Tools this skill uses (from office-mcp)
- extract_text_from_pdf
- extract_text_from_docx
- analyze_document_structure
optional_tools: # Nice-to-have tools
- create_docx
- docx_to_pdf
# ─────────────────────────────────────────────────────────────────────────────────
# EXTERNAL DATA SOURCES (Optional - for data-driven skills)
# ─────────────────────────────────────────────────────────────────────────────────
# data_sources:
# - name: Alpha Vantage
# url: https://www.alphavantage.co/
# type: api
# api_key_required: true
# rate_limit: "5 requests/minute (free tier)"
# - name: Yahoo Finance
# url: https://finance.yahoo.com/
# type: web
# api_key_required: false
# ─────────────────────────────────────────────────────────────────────────────────
# INPUT/OUTPUT SPECIFICATION (Recommended)
# ─────────────────────────────────────────────────────────────────────────────────
input:
required:
- type: file
formats: [pdf, docx]
description: The contract document to review
- type: text
name: party_role
description: Which party you are (employee, contractor, buyer, etc.)
optional:
- type: text
name: jurisdiction
description: Legal jurisdiction (US, EU, China, etc.)
- type: text
name: concerns
description: Specific areas of concern
output:
primary:
type: report
format: markdown
sections:
- risk_summary
- detailed_findings
- recommendations
artifacts:
- type: file
name: analysis_report.md
description: Detailed analysis report
# ─────────────────────────────────────────────────────────────────────────────────
# SKILL CAPABILITIES (For discovery/matching)
# ─────────────────────────────────────────────────────────────────────────────────
capabilities:
- contract_analysis
- risk_identification
- legal_compliance_check
- negotiation_recommendations
# ─────────────────────────────────────────────────────────────────────────────────
# LANGUAGE SUPPORT
# ─────────────────────────────────────────────────────────────────────────────────
languages:
- en # English
- zh # Chinese
# ─────────────────────────────────────────────────────────────────────────────────
# RELATED SKILLS (For navigation/discovery)
# ─────────────────────────────────────────────────────────────────────────────────
related_skills:
- nda-generator
- offer-letter
- proposal-writer
---
# Skill Name
## Overview
[Clear explanation of what this skill does and when to use it]
**What I can do:**
- [Capability 1]
- [Capability 2]
- [Capability 3]
**What I cannot do:**
- [Limitation 1]
- [Limitation 2]
---
## How to Use Me
### Step 1: [First Step]
[Instructions]
### Step 2: [Second Step]
[Instructions]
### Step 3: [Third Step]
[Instructions]
---
## Domain Knowledge
[This is where the real value lives - embedded expertise, patterns, rules, best practices]
### [Knowledge Area 1]
[Details]
### [Knowledge Area 2]
[Details]
---
## Output Format
[Define the structure of outputs this skill produces]
```
## [Output Title]
### Section 1
[Content pattern]
### Section 2
[Content pattern]
```
---
## Examples
### Example 1: [Scenario]
**User**: [Example input]
**AI**: [Example output]
### Example 2: [Scenario]
**User**: [Example input]
**AI**: [Example output]
---
## Tips for Better Results
1. [Tip 1]
2. [Tip 2]
3. [Tip 3]
---
## Limitations
- [Limitation 1]
- [Limitation 2]
- [Limitation 3]
---
*Built by the Claude Office Skills community. Contributions welcome!*
© claude-office-skills · MIT · claude-office-skills/skills
Similar skills
All skills for Agent setup: memory, context, orchestration →skill-name by other authors comes first.