Claude Code Skills para Microsoft 365
roshannaik/claude-skills
Integração nativa com OneNote, Office e manutenção de código
Ver no GitHubConjunto de three skills Python que integram Claude Code com Microsoft 365, permitindo leitura/escrita em OneNote, Excel, Word e PowerPoint via Microsoft Graph API, além de auditoria e limpeza de código incrementalmente evoluído.
Instalação
npx convez-ai roshannaik/claude-skills1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar leitura e escrita em notebooks OneNote via Claude Code
- Manipular arquivos Excel, Word e PowerPoint armazenados em OneDrive
- Auditar e limpar código incrementalmente evoluído com workflow holístico
Veredito

Skills bem estruturados com autenticação device-code segura e integração robusta ao ecossistema Microsoft 365. Exigem setup inicial (Azure app registration) mas oferecem automação produtiva para fluxos Office + código em Claude Code — recomendado para usuários de Microsoft 365 que trabalham com documentação e manutenção de código.
README
A tradução para o português deste README ainda está na fila.
Claude Code Skills
Three skills for Claude Code and that connect to Microsoft 365 and provide a code maintenance workflow.
| Skill | What it does |
|---|---|
onenote | Read and write OneNote notebooks via Microsoft Graph API |
office | Read and write Excel, Word, and PowerPoint files on OneDrive |
code-maintenance | Holistic audit and cleanup of incrementally evolved code |
Prerequisites
1. Python 3.11+
python3 --version # should be 3.11 or higher
If not installed (macOS): brew install python
macOS only. These skills assume a macOS environment (zsh,
~/.claude/skills).
2. Python dependencies (onenote + office skills only)
Each skill ships its own requirements.txt:
pip3 install -r onenote/requirements.txt # for the onenote skill
pip3 install -r office/requirements.txt # for the office skill
3. Azure app registration (onenote + office skills only)
The skills authenticate via Microsoft's device-code flow — no browser popup, works in the terminal. You need to register an app in Azure to get a Client ID.
Steps:
- Go to https://portal.azure.com and sign in with your Microsoft account.
- Navigate to Azure Active Directory → App registrations → New registration.
- Name: anything (e.g.
claude-skills) - Supported account types: Personal Microsoft accounts only
- Redirect URI: leave blank
- Click Register
- Copy the Application (client) ID — you'll need it in the next step.
- Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions and add:
Notes.ReadNotes.ReadWriteFiles.ReadFiles.ReadWriteUser.Read
- Click Grant admin consent (or just proceed — it will prompt on first auth).
4. Google AI Studio API key (onenote skill only)
The onenote skill uses Gemini for semantic-search embeddings, image OCR, and audio/video transcription. Without it, /onenote query (semantic search) will not work.
Get a free key at https://aistudio.google.com/apikey. The office and code-maintenance skills do not need this.
5. Set the environment variables
Add to your ~/.zshrc:
export MS_CLIENT_ID="your-client-id-from-step-7-above" # onenote + office
export GEMINI_API_KEY="your-google-ai-studio-key" # onenote only
Then reload:
source ~/.zshrc
Installation
git clone https://github.com/roshannaik/claude-skills.git skills
cd skills
./install.sh
This symlinks each skill into ~/.claude/skills/<skill>, pointing back to the cloned repo. No files are copied — edits in the repo are reflected immediately, and git pull is all you need to update.
First-time authentication (onenote + office)
From the cloned repo directory (skills/):
python3 onenote/scripts/onenote_setup.py
This prints a device code and a URL. Open the URL in any browser, enter the code, and sign in. The token is cached at ~/.cache/ms_graph_token_cache.json — subsequent runs skip this step entirely.
Usage
Once installed, invoke skills in Claude Code with a / prefix:
/onenote read MyNotebook/MySection/MyPage
/office read budget.xlsx
/code-maintenance ~/.claude/skills/onenote
Or just describe what you want in natural language — Claude Code will invoke the right skill automatically.
What gets cached (and what doesn't get committed)
The onenote and office skills cache API responses locally for speed:
onenote/cache/— notebook/section/page index and page contentoffice/cache/excel/— Excel tab descriptions
These directories are in .gitignore and never committed. They are rebuilt automatically on first use on a new machine.
Updating
git pull
No reinstall needed — the symlinks stay valid.