llm agent skills

Focused Codex and Claude skills, currently centered on Windows Office automation plus a reusable SART clinic-data research workflow.

Canonical GitHub About settings:

• Description: Windows-native Codex skills for Word, PowerPoint, and Excel using Microsoft Office COM automation.
• Topics: codex, skills, windows, powershell, python, microsoft-office, office-automation, word, powerpoint, excel, com-automation
• Homepage: leave blank until the repository has a real external docs or project site

Why This Repo Exists

This repository started as a home for Office-oriented skills ported from Anthropic's skills repository into Codex-friendly Windows workflows.

It now also hosts narrowly scoped original skills when the workflow is stable, reusable, and benefits from explicit operating guidance. The current catalog is still Office-heavy, but not Office-exclusive.

For the Office skills, the core design choice remains deliberate: prefer local Microsoft Office desktop automation over LibreOffice-style file transformation whenever Word, PowerPoint, or Excel fidelity matters. Those skills are Windows-specific and environment-dependent by design.

The Office COM entrypoints now share a common runtime for session preflight, input-desktop checks, and normalized reroute behavior when COM is unavailable from a sandboxed or non-interactive shell.

Skill Catalog

Skill	Engine	Upstream source	Smoke test
docx-win	Microsoft Word COM + PowerShell	anthropics/skills -> skills/docx	powershell -ExecutionPolicy Bypass -File .\docx-win\scripts\smoke-test.ps1
pptx-win	Microsoft PowerPoint COM + PowerShell, OOXML fallback	anthropics/skills -> skills/pptx	powershell -ExecutionPolicy Bypass -File .\pptx-win\scripts\smoke_test.ps1
xlsx-win	Microsoft Excel COM + PowerShell, Python helpers	anthropics/skills -> skills/xlsx	powershell -ExecutionPolicy Bypass -File .\xlsx-win\scripts\self_test_xlsx_win.ps1
sart-clinic-data-access	Search-first SART public-site workflow	User-provided SART Clinic Data Access Instructions.md	Manual live Codex test: PKID lookup plus report-page selection

Prerequisites

• Codex or Claude configured to load local skills from your skills directory
• For docx-win, pptx-win, and xlsx-win: Windows with a local interactive desktop session
• For docx-win, pptx-win, and xlsx-win: Microsoft 365 desktop apps installed for the relevant skill
• PowerShell for the Office automation entrypoints and repo validation scripts
• Python 3 for the bundled Python helpers and repo tooling
• For sart-clinic-data-access: a session that can search and open public web pages

Installation

Codex

1. Clone this repository locally.

2. Copy the shared runtime folder .shared\office-com and the skill folders you want to use into your Codex skills directory, for example %USERPROFILE%\.codex\skills\.

3. Keep the directory names unchanged: .shared, docx-win, pptx-win, xlsx-win, and sart-clinic-data-access.

4. Use the skill by name from Codex, for example $docx-win, $pptx-win, $xlsx-win, or $sart-clinic-data-access.

5. Before relying on Excel, PowerPoint, or Word COM from a new machine or session, run the shared preflight from a signed-in desktop-user PowerShell window:

   & "$env:USERPROFILE\.codex\skills\.shared\office-com\scripts\office_com_preflight.ps1" -Apps @('Excel','PowerPoint','Word')

6. Run the relevant smoke test or live validation before relying on a new machine or session.

Claude Code

1. Clone this repository locally.
2. In your project's .claude/skills/ directory, copy or symlink the desired subdirectories from .claude/skills/ in this repository: docx-win, pptx-win, xlsx-win, and sart-clinic-data-access.
3. If you plan to use the Office skills, also copy the shared runtime folder .shared\office-com from this repository into .claude\skills\.shared\office-com so the skill wrappers can resolve their shared preflight module.
4. Keep the directory names unchanged.
5. Reference each skill from a CLAUDE.md or system prompt by its name, for example docx-win, pptx-win, xlsx-win, or sart-clinic-data-access.
6. Run the relevant smoke test or live validation before relying on a new machine or session.

Validation And CI

The repository uses a two-tier validation model.

Hosted validation runs in GitHub Actions on windows-latest:

• YAML parse and required-field validation for every agents/openai.yaml
• SKILL.md front matter and internal scripts/... and references/... path validation
• PowerShell parser checks plus PSScriptAnalyzer with a repo-owned rule set
• Python syntax compilation for the bundled .py files

Office runtime validation is separate because GitHub-hosted runners do not provide reliable Microsoft Office COM automation:

• .github/workflows/office-smoke.yml is designed for a self-hosted Windows runner labeled office
• it runs the Word, PowerPoint, and Excel smoke tests
• it uploads logs and generated artifacts for debugging
• it can be started manually or requested from a pull request with /office-smoke

Docs-first web-research skills use manual live validation instead of a repo script. For sart-clinic-data-access, the smoke test is a real PKID lookup followed by opening the correct SART report page for the requested metric.

Local validation commands:

pwsh -NoLogo -NoProfile -File .\tools\validate_repo.ps1
pwsh -NoLogo -NoProfile -File .\tools\validate_powershell.ps1 -SettingsPath .github\PSScriptAnalyzerSettings.psd1
python -m compileall -q .\pptx-win\scripts .\xlsx-win\scripts .\tools

Repo Layout

• .shared/office-com/: shared Office COM preflight and guard runtime used by Excel, PowerPoint, and Word wrappers
• docx-win/: Word skill, scripts, references, and agent metadata
• pptx-win/: PowerPoint skill, scripts, references, fallback OOXML utilities, and agent metadata
• sart-clinic-data-access/: SART clinic PKID and report-access workflow skill
• xlsx-win/: Excel skill, scripts, references, and agent metadata
• .github/workflows/: hosted validation and self-hosted Office smoke workflows
• tools/: repository validation helpers used by CI and local contributors

Contributing

Contributions should preserve each skill's documented contract:

• keep the Office skills Windows-specific and COM-first unless the skill explicitly documents a fallback path
• keep docs-first skills concise, reproducible, and explicit about any search/open constraints
• update agents/openai.yaml together with any skill behavior changes
• keep SKILL.md examples and referenced scripts in sync
• run the hosted validation commands locally before opening a PR
• request the Office smoke workflow when a change affects runtime Office automation behavior

Licensing And Provenance

This repository records provenance for each skill but does not currently publish a root LICENSE file.

Before redistributing or repackaging this repository, review the upstream provenance and decide on an explicit licensing policy for the repo as a whole.

Current upstream provenance:

Skill	Upstream repo	Source folder	Source branch	Port depth
docx-win	https://github.com/anthropics/skills	skills/docx	main	Light port
pptx-win	https://github.com/anthropics/skills	skills/pptx	main	Light port
sart-clinic-data-access	User-provided private source notes	SART Clinic Data Access Instructions.md	2026-04-08	Original skill
xlsx-win	https://github.com/anthropics/skills	skills/xlsx	main	Heavy adaptation