AgentSkills Collection

A curated collection of AgentSkills for AI development tools. These skills enable AI agents to interact with popular services and APIs including Microsoft 365, package tracking, budget management, and smart home control.

🎯 What are AgentSkills?

AgentSkills are folders containing instructions, scripts, and resources that AI agents can discover and use to perform tasks more accurately and efficiently. They work across multiple AI development platforms including Claude Code, Cursor, VS Code, and GitHub Copilot.

📦 Skills in this Collection

Microsoft 365

Access Microsoft 365 data via Microsoft Graph API.

• Features: Read emails, search messages, get user profile information
• API: Microsoft Graph API
• Auth: Azure AD client credentials (service principal)
• Scripts: 3 TypeScript utilities

Parcel Tracking

Track package deliveries using the Parcel app API.

• Features: View deliveries, add tracking numbers, check status updates
• API: Parcel app API (parcelapp.net)
• Auth: API key
• Scripts: 4 TypeScript utilities

YNAB Budget Management

Access and manage budgets with YNAB (You Need A Budget).

• Features: View budgets, accounts, categories, transactions; create transactions
• API: YNAB API
• Auth: Personal Access Token
• Scripts: 7 TypeScript utilities

BiomeJS Configuration

Configure BiomeJS for linting, formatting, and code style enforcement.

• Features: New project setup, migration/upgrade, framework-aware adaptive rules
• Type: Instruction-only (no scripts)
• Auth: None required

Home Assistant

Control and monitor your smart home with Home Assistant.

• Features: Get entity states, call services, fire events, query history
• API: Home Assistant REST API
• Auth: Long-Lived Access Token
• Scripts: 6 TypeScript utilities

🚀 Quick Start

Installing a Skill

For Claude Code:

# Install all skills
cp -r biome ms365 parcel-tracking ynab home-assistant ~/.claude/skills/

# Or install individual skills
cp -r ynab ~/.claude/skills/

For other platforms:

# Project-specific installation
cp -r <skill-name> .claude/skills/

# Or follow your platform's skill installation guide

Building a Skill

Each skill requires building TypeScript scripts:

cd <skill-name>/scripts
npm install
npm run build

Configuration

Each skill requires environment variables for authentication. See individual skill documentation:

• ms365/SETUP.md - Azure AD setup
• parcel-tracking/references/SETUP.md - Parcel API key
• ynab/references/SETUP.md - YNAB Personal Access Token
• home-assistant/references/SETUP.md - Home Assistant Long-Lived Access Token

📚 Documentation

Each skill includes comprehensive documentation:

• SKILL.md - Usage instructions and examples (loaded by AI agents)
• README.md - Overview and quick start (for humans)
• references/SETUP.md - Detailed setup and configuration
• references/API.md - Complete API reference

🧪 Testing & Validation

Validate all skills in the repository:

npm install
npm test

This checks:

• ✅ SKILL.md YAML frontmatter validity
• ✅ Required files exist
• ✅ TypeScript compilation succeeds
• ✅ Scripts are executable
• ✅ AgentSkills specification compliance

🛠️ Development

Repository Structure

agentskills-collection/
├── README.md                 # This file
├── LICENSE                   # MIT License
├── CONTRIBUTING.md           # Contribution guidelines
├── package.json              # Root tooling and scripts
├── tests/                    # Validation tests
│   └── validate-skills.js    # Skill validator
├── biome/                    # BiomeJS configuration skill
│   ├── SKILL.md
│   └── README.md
├── ms365/                    # Microsoft 365 skill
│   ├── SKILL.md
│   ├── README.md
│   ├── SETUP.md
│   └── scripts/
├── parcel-tracking/          # Parcel tracking skill
│   ├── SKILL.md
│   ├── README.md
│   ├── references/
│   └── scripts/
├── ynab/                     # YNAB budget skill
│   ├── SKILL.md
│   ├── README.md
│   ├── references/
│   └── scripts/
└── home-assistant/           # Home Assistant smart home skill
    ├── SKILL.md
    ├── README.md
    ├── references/
    └── scripts/

Building All Skills

# Install dependencies and build all skills
npm run build:all

# Or build individually
cd <skill-name>/scripts && npm install && npm run build

Adding a New Skill

1. Create skill directory following AgentSkills specification
2. Include required files: SKILL.md, README.md
3. Add build scripts if needed
4. Update this README with skill details
5. Run validation: npm test
6. Submit a pull request

See CONTRIBUTING.md for detailed guidelines.

🔒 Security

Important: These skills require API credentials and access tokens. Always:

• ✅ Store credentials as environment variables
• ✅ Never commit credentials to version control
• ✅ Use .gitignore to exclude sensitive files
• ✅ Follow principle of least privilege for API permissions
• ✅ Rotate credentials regularly
• ✅ Review each skill's security documentation

🤝 Compatible Platforms

These skills follow the AgentSkills specification and work with:

• Claude Code - Anthropic's official CLI
• Cursor - AI-powered IDE
• VS Code - With compatible extensions
• GitHub Copilot - In supported environments
• Any other AgentSkills-compatible tool

📋 Requirements

• Node.js 18 or higher (for TypeScript scripts)
• npm 8 or higher (for dependency management)
• Active accounts and credentials for services you want to use

📄 License

This collection is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Built following the AgentSkills specification
• Originally developed by Anthropic and released as an open standard
• Inspired by the AgentSkills community and examples

🐛 Issues & Support

• Report issues: GitHub Issues
• Feature requests: GitHub Discussions
• Security concerns: See SECURITY.md

For service-specific issues:

• Microsoft Graph API: Microsoft Support
• Parcel API: support@parcelapp.net
• YNAB API: api@ynab.com
• Home Assistant API: Home Assistant Community

🔗 Resources

• AgentSkills Official Site
• AgentSkills Specification
• AgentSkills GitHub
• Example Skills Repository

---

Made with ❤️ for the AgentSkills community