M365 Agent Evaluator
microsoft/work-iq
A skill your agent uses when a user wants to create, run, or analyze evaluation suites for Microsoft 365 Copilot declarative agents with the public @microsoft/m365-copilot-eval CLI.
Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
Install Declarative Agents
$ npx skills add github/awesome-copilot --skill declarative-agents -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install github/awesome-copilot declarative-agents --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/declarative-agents .claude/skills/declarative-agents && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "declarative-agents" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/declarative-agents into .claude/skills/declarative-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agents", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/github/awesome-copilot/tree/main/skills/declarative-agentsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add github/awesome-copilot --skill declarative-agents -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install github/awesome-copilot declarative-agents --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/declarative-agents .agents/skills/declarative-agents && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "declarative-agents" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/declarative-agents into .agents/skills/declarative-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agents", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add github/awesome-copilot --skill declarative-agents -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install github/awesome-copilot declarative-agents --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/declarative-agents .cursor/skills/declarative-agents && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "declarative-agents" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/declarative-agents into .cursor/skills/declarative-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agents", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/github/awesome-copilot.git --path skills/declarative-agents--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add github/awesome-copilot --skill declarative-agents -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install github/awesome-copilot declarative-agents --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/declarative-agents .gemini/skills/declarative-agents && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "declarative-agents" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/declarative-agents into .gemini/skills/declarative-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agents", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install github/awesome-copilot declarative-agentsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add github/awesome-copilot --skill declarative-agents -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/declarative-agents .github/skills/declarative-agents && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "declarative-agents" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/declarative-agents into .github/skills/declarative-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agents", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add github/awesome-copilot --skill declarative-agents -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install github/awesome-copilot declarative-agents --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/github/awesome-copilot.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/declarative-agents .opencode/skills/declarative-agents && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "declarative-agents" agent skill from https://github.com/github/awesome-copilot/tree/main/skills/declarative-agents into .opencode/skills/declarative-agents/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "declarative-agents", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
declarative-agents- GitHub stars
- 40k
- Used in
- 1 other repo
- Token cost
- ~1.2k tokens
- SKILL.md length
- 460 words
- Files
- 1
- Skills in repo
- 417
- Repo updated
- First seen
- Licence
- MIT
At a glance
Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
- Works in 6 steps: Agent Planning: Define purpose, target… → Capability Selection: Choose from 11… → Basic Schema Creation: Generate… → …
- Tasks that involve Cloud office suites
- SKILL.md covers Workflow 1: Basic Agent Creation, Workflow 2: Advanced…, Workflow 3: Validation &… and Core Features Across All…
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Declarative Agents is an agent skill from github/awesome-copilot, published by the product's own GitHub organization. Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Documents & Office, covering Cloud office suites. It works with Microsoft 365. The repository describes itself as: Community-contributed instructions, agents, skills, and configurations to help you make the most of GitHub Copilot. The licence is MIT.
When your agent uses it
- Tasks that involve Cloud office suites
Example prompts
- “/declarative-agents”
Workflow steps
6 steps, taken from the first numbered list in SKILL.md.
- Agent Planning: Define purpose, target users, and core capabilities
- Capability Selection: Choose from 11 available capabilities (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
- Basic Schema Creation: Generate compliant JSON manifest with proper constraints
- TypeSpec Alternative: Create modern type-safe definitions that compile to JSON
- Testing Setup: Configure Agents Playground for local testing
- Toolkit Integration: Leverage Microsoft 365 Agents Toolkit for enhanced development
What it can do on your machine
Read from SKILL.md and the folder at commit 727ff2e. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are typespec and json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Declarative Agents loads about 1.2k tokens when it runs. Until then it costs about 54 tokens; SKILL.md has 460 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from github/awesome-copilot at commit 727ff2e, republished under its MIT licence (© github). 460 words, ~1,178 tokens.
Download SKILL.mdSave it as
.claude/skills/declarative-agents/SKILL.md (or your agent's skills folder).- name
- declarative-agents
- description
- Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
Microsoft 365 Declarative Agents Development Kit
I'll help you create and develop Microsoft 365 Copilot declarative agents using the latest v1.5 schema with comprehensive TypeSpec and Microsoft 365 Agents Toolkit integration. Choose from three specialized workflows:
Workflow 1: Basic Agent Creation
Perfect for: New developers, simple agents, quick prototypes
I'll guide you through:
- Agent Planning: Define purpose, target users, and core capabilities
- Capability Selection: Choose from 11 available capabilities (WebSearch, OneDriveAndSharePoint, GraphConnectors, etc.)
- Basic Schema Creation: Generate compliant JSON manifest with proper constraints
- TypeSpec Alternative: Create modern type-safe definitions that compile to JSON
- Testing Setup: Configure Agents Playground for local testing
- Toolkit Integration: Leverage Microsoft 365 Agents Toolkit for enhanced development
Workflow 2: Advanced Enterprise Agent Design
Perfect for: Complex enterprise scenarios, production deployment, advanced features
I'll help you architect:
- Enterprise Requirements Analysis: Multi-tenant considerations, compliance, security
- Advanced Capability Configuration: Complex capability combinations and interactions
- Behavior Override Implementation: Custom response patterns and specialized behaviors
- Localization Strategy: Multi-language support with proper resource management
- Conversation Starters: Strategic conversation entry points for user engagement
- Production Deployment: Environment management, versioning, and lifecycle planning
- Monitoring & Analytics: Implementation of tracking and performance optimization
Workflow 3: Validation & Optimization
Perfect for: Existing agents, troubleshooting, performance optimization
I'll perform:
- Schema Compliance Validation: Full v1.5 specification adherence checking
- Character Limit Optimization: Name (100), description (1000), instructions (8000)
- Capability Audit: Verify proper capability configuration and usage
- TypeSpec Migration: Convert existing JSON to modern TypeSpec definitions
- Testing Protocol: Comprehensive validation using Agents Playground
- Performance Analysis: Identify bottlenecks and optimization opportunities
- Best Practices Review: Alignment with Microsoft guidelines and recommendations
Show full SKILL.md (183 more words)Show less
Core Features Across All Workflows
Microsoft 365 Agents Toolkit Integration
- VS Code Extension: Full integration with
teamsdevapp.ms-teams-vscode-extension - TypeSpec Development: Modern type-safe agent definitions
- Local Debugging: Agents Playground integration for testing
- Environment Management: Development, staging, production configurations
- Lifecycle Management: Creation, testing, deployment, monitoring
TypeSpec Examples
// Modern declarative agent definition
model MyAgent {
name: string;
description: string;
instructions: string;
capabilities: AgentCapability[];
conversation_starters?: ConversationStarter[];
}JSON Schema v1.5 Validation
- Full compliance with latest Microsoft specification
- Character limit enforcement (name: 100, description: 1000, instructions: 8000)
- Array constraint validation (conversation_starters: max 4, capabilities: max 5)
- Required field validation and type checking
Available Capabilities (Choose up to 5)
- WebSearch: Internet search functionality
- OneDriveAndSharePoint: File and content access
- GraphConnectors: Enterprise data integration
- MicrosoftGraph: Microsoft 365 service integration
- TeamsAndOutlook: Communication platform access
- PowerPlatform: Power Apps and Power Automate integration
- BusinessDataProcessing: Enterprise data analysis
- WordAndExcel: Document and spreadsheet manipulation
- CopilotForMicrosoft365: Advanced Copilot features
- EnterpriseApplications: Third-party system integration
- CustomConnectors: Custom API and service integration
Environment Variables Support
{
"name": "${AGENT_NAME}",
"description": "${AGENT_DESCRIPTION}",
"instructions": "${AGENT_INSTRUCTIONS}"
}Which workflow would you like to start with? Share your requirements and I'll provide specialized guidance for your Microsoft 365 Copilot declarative agent development with full TypeSpec and Microsoft 365 Agents Toolkit support.
© github, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/declarative-agents of github/awesome-copilot.
Open the folder on GitHubat commit 727ff2e
Used in 1 other repository
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in github/awesome-copilot, which our catalogue first saw on October 7, 2026.
Compare with similar skills
Declarative Agents next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Declarative Agents this skillgithub/awesome-copilot | 40k | 1 repos | ~1.2k | Automated safety check: Pass | MIT | |
| M365 Agent Evaluatormicrosoft/work-iq | 1k | — | ~2k | Automated safety check: Notes | Custom licence | |
| Microsoft 365 Agents ToolkitOfficeDev/microsoft-365-agents-toolkit | 781 | — | ~2.8k | Automated safety check: Notes | Custom licence | |
| Msgraphcodemie-ai/codemie-code | 294 | — | ~4.1k | Automated safety check: Pass | Apache-2.0 | |
| aai-cli Microsoft 365aai-labs/agent-barn | 109 | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| Workiqmicrosoft/work-iq | 1k | — | ~15k | Automated safety check: Pass | Custom licence |
Similar skills
- Official
Microsoft 365 Agents Toolkit
OfficeDev/microsoft-365-agents-toolkit
Builds, tests, and deploys Microsoft 365 apps and agents for Teams and Copilot.
Msgraph
codemie-ai/codemie-code
Work with Microsoft 365 services via the Graph API — emails, calendar events, SharePoint sites (read and write), Teams chats and channel messages, OneDrive files, OneNote notebooks, Planner task…
aai-cli Microsoft 365
aai-labs/agent-barn
Guides work with Outlook, OneDrive, SharePoint, Teams, Excel, To Do and Planner through aai-cli's Microsoft Graph commands, starting from which service owns the data.
- Official
Workiq
microsoft/work-iq
WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.
- Official
Workiq Preview
microsoft/work-iq
WorkIQ tools for Microsoft 365 workplace data and actions. An agent skill from microsoft/work-iq.
More from github/awesome-copilot
All 417 skills in this repo- Official
Acquire Codebase Knowledge
github/awesome-copilot
Maps an unfamiliar codebase into seven evidence-backed documents in docs/codebase/, using a scan script and templates, for onboarding or architecture write-ups.
- Official
Azure Architecture Autopilot
github/awesome-copilot
Designs Azure infrastructure from a natural-language description, or diagrams an existing resource group, then refines the design through conversation and deploys it with Bicep.
- Official
Draw.io Diagram Generator
github/awesome-copilot
Generates, edits and validates draw.io files with correct mxGraph XML, covering flowcharts, architecture, sequence, ER and UML class diagrams.
- Official
Credit Risk Data Cleaning
github/awesome-copilot
Cleans raw credit data and screens variables before loan modeling, dropping unstable, noisy or redundant features and writing an Excel report of every step.
- Official
Daily Focus Board
github/awesome-copilot
Builds a warm, browser-based daily focus board the user updates by talking to their agent, with Eisenhower priorities, a brain-dump box and kind not-today carryover.
- Official
Python Pypi Package Builder
github/awesome-copilot
End-to-end skill for building, testing, linting, versioning, and publishing a production-grade Python library to PyPI.
Related
Works with
Categories
Questions about Declarative Agents
What does Declarative Agents do?
Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration. Declarative Agents is an agent skill from github/awesome-copilot, published by the product's own GitHub organization.
When should I use Declarative Agents?
Declarative Agents fits situations like: tasks that involve Cloud office suites.
How do I install Declarative Agents in Claude Code?
Run `npx skills add github/awesome-copilot --skill declarative-agents -a claude-code`. Or copy the skill folder (skills/declarative-agents in github/awesome-copilot) into .claude/skills/declarative-agents in your project. Claude Code loads it when a task matches its description.
How do I install Declarative Agents in Codex?
Run `npx skills add github/awesome-copilot --skill declarative-agents -a codex`. Or copy the skill folder (skills/declarative-agents in github/awesome-copilot) into .agents/skills/declarative-agents in your project. Codex loads it when a task matches its description.
Can I use Declarative Agents in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add github/awesome-copilot --skill declarative-agents -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/declarative-agents, .gemini/skills/declarative-agents, .github/skills/declarative-agents and .opencode/skills/declarative-agents in your project.
What does Declarative Agents need to run?
SKILL.md names no scripts, command-line tools or credentials: Declarative Agents is instructions for the agent only.
Does Declarative Agents access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Declarative Agents safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Declarative Agents use?
Declarative Agents is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Declarative Agents use?
About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Declarative Agents?
Skills that share tags, products or a category with Declarative Agents: M365 Agent Evaluator (microsoft/work-iq, 1k stars), Microsoft 365 Agents Toolkit (OfficeDev/microsoft-365-agents-toolkit, 781 stars), Msgraph (codemie-ai/codemie-code, 294 stars) and aai-cli Microsoft 365 (aai-labs/agent-barn, 109 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Declarative Agents?
github (a GitHub organization, an official publisher) maintains it in github/awesome-copilot, which has 39,748 GitHub stars. The repository holds 417 skills in this directory. The repository was last updated on October 7, 2026.
Source: github/awesome-copilot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.