convez.ai
SkillIntegração & APIsIntermediário
roshannaik

Claude Code Skills para Microsoft 365

roshannaik/claude-skills

Integração nativa com OneNote, Office e manutenção de código

Ver no GitHub
InicialPluginScore · de 0 a 100

Conjunto 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-skills

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 3 semanas
Versão
—
Issues abertas
0
Contribuidores
2

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.

SkillWhat it does
onenoteRead and write OneNote notebooks via Microsoft Graph API
officeRead and write Excel, Word, and PowerPoint files on OneDrive
code-maintenanceHolistic 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:

  1. Go to https://portal.azure.com and sign in with your Microsoft account.
  2. Navigate to Azure Active Directory → App registrations → New registration.
  3. Name: anything (e.g. claude-skills)
  4. Supported account types: Personal Microsoft accounts only
  5. Redirect URI: leave blank
  6. Click Register
  7. Copy the Application (client) ID — you'll need it in the next step.
  8. Go to API permissions → Add a permission → Microsoft Graph → Delegated permissions and add:
    • Notes.Read
    • Notes.ReadWrite
    • Files.Read
    • Files.ReadWrite
    • User.Read
  9. 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 content
  • office/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.

Ver o original no GitHub

Bom para

Relacionados