declarative-agents skill
Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration
Is the declarative-agents skill safe?
Clean: nothing in its files matched our rules. We read 1 file in the folder on 2026-09-28.
No findings.
Install the declarative-agents skill
A skill is a folder. Copy it into your agent's skills folder and the agent loads it when the task matches its description.
git clone --depth 1 https://github.com/github/awesome-copilot.git /tmp/awesome-copilot mkdir -p ~/.claude/skills cp -r /tmp/awesome-copilot/skills/declarative-agents ~/.claude/skills/declarative-agents
In the Claude apps, zip the folder and upload it from the Skills settings. The folder on GitHub
The instructions your agent would load
SKILL.md as published, without the frontmatter. Read it on GitHub
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
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.
More skills from github/awesome-copilot
- Aacquire-codebase-knowledgeUse this skill when the user explicitly asks to map, document, or onboard into an existing codebase. Trigger for prompts like "map this codebase", "document this architecture", "onboard me to this repo", or "create codebase docs". Do not trigger for routine feature implementation, bug fixes, or narrow code edits unless the user asks for repository-level discovery.
- Aacreadiness-assessRun the AgentRC readiness assessment on the current repository and produce a static HTML dashboard at reports/index.html. Wraps `npx github:microsoft/agentrc readiness` and hands off rendering to the @ai-readiness-reporter custom agent. Supports policies (--policy) for org-specific scoring. Use when asked to assess, audit, or score the AI readiness of a repo.
- Aacreadiness-generate-instructionsGenerate tailored AI agent instruction files via AgentRC instructions command. Produces .github/copilot-instructions.md (default, recommended for Copilot in VS Code) plus optional per-area .instructions.md files with applyTo globs for monorepos. Use after running /acreadiness-assess to close gaps in the AI Tooling pillar.
- Aacreadiness-policyHelp the user pick, write, or apply an AgentRC policy. Policies customise readiness scoring by disabling irrelevant checks, overriding impact/level, setting pass-rate thresholds, or chaining org baselines with team overrides. Use when the user asks about strict mode, AI-only scoring, custom weights, CI gating, or wants org-wide standardisation.
- Aad-campaign-analyzerUse this skill when the user shares ad campaign performance data and asks what to cut, scale, or test. Trigger for prompts like "analyze my ad campaigns", "where am I wasting ad spend", "reallocate my ad budget", "which ads are actually working", or "ROAS analysis". Do not trigger for campaign planning or creative generation without performance data.
- Aadd-educational-commentsAdd educational comments to the file specified, or prompt asking for file to comment if one is not provided.
- Aadobe-illustrator-scriptingWrite, debug, and optimize Adobe Illustrator automation scripts using ExtendScript (JavaScript/JSX). Use when creating or modifying scripts that manipulate documents, layers, paths, text frames, colors, symbols, artboards, or any Illustrator DOM objects. Covers the complete JavaScript object model, coordinate system, measurement units, export workflows, and scripting best practices.
- Aagent-architectureDesign AI agent architectures through requirements discovery, or audit and diagnose architectural flaws in existing agents. Architecture only; excludes implementation and general code review.
- Aagent-governancePatterns and techniques for adding governance, safety, and trust controls to AI agent systems. Use this skill when: - Building AI agents that call external tools (APIs, databases, file systems) - Implementing policy-based access controls for agent tool usage - Adding semantic intent classification to detect dangerous prompts - Creating trust scoring systems for multi-agent workflows - Building audit trails for agent actions and decisions - Enforcing rate limits, content filters, or tool restrictions on agents - Working with any agent framework (PydanticAI, CrewAI, OpenAI Agents, LangChain, AutoGen)
- Aagent-owasp-complianceCheck any AI agent codebase against the OWASP Agentic Security Initiative (ASI) Top 10 risks. Use this skill when: - Evaluating an agent system's security posture before production deployment - Running a compliance check against OWASP ASI 2026 standards - Mapping existing security controls to the 10 agentic risks - Generating a compliance report for security review or audit - Comparing agent framework security features against the standard - Any request like "is my agent OWASP compliant?", "check ASI compliance", or "agentic security audit"
- Aagent-skill-stackFind, evaluate, and assemble the smallest compatible set of AI Agent Skills for an end-to-end natural-language goal. Use when a user wants Skills for a multi-step workflow, asks which Skills fit a project, needs an installed-Skill audit or conflict check, has low Skill recall, wants indirect helpers such as humanizers or compliance checks, or wants a project-specific Skill Stack with controlled installation. Search local Skills, registries, GitHub, and OpenCLI; compare adoption, verified fit, safety, and overlap. Do not use for locating one known or common Skill; use the generic find-skills workflow.
- Aagent-supply-chainVerify supply chain integrity for AI agent plugins, tools, and dependencies. Use this skill when: - Generating SHA-256 integrity manifests for agent plugins or tool packages - Verifying that installed plugins match their published manifests - Detecting tampered, modified, or untracked files in agent tool directories - Auditing dependency pinning and version policies for agent components - Building provenance chains for agent plugin promotion (dev → staging → production) - Any request like "verify plugin integrity", "generate manifest", "check supply chain", or "sign this plugin"