skills.rest
microsoft
microsoftOFFICIAL
Explore all skills by this author →
Website𝕏@OpenAtMicrosoftGitHub

int-project-context

Provide shared project context and guidance for Copilot Studio agent YAML projects.

391|88|Updated Jan 13, 2026
Search Tags:#validation#agent#yaml#project-context#copilot-studio#schema-lookup#connector-lookup
One-click install
npx skills add https://github.com/microsoft/skills-for-copilot-studio --skill int-project-context
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: int-project-context
Source: https://github.com/microsoft/skills-for-copilot-studio/tree/main/skills/int-project-context
Command: npx skills add https://github.com/microsoft/skills-for-copilot-studio --skill int-project-context

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Provides a consistent project structure, schema and connector lookup guidance, and skill-invocation conventions so authors and tools can author, validate, and maintain Copilot Studio agent YAML reliably and without common schema or routing errors.

Core Features & Use Cases

  • Project discovery and structure: Defines the expected layout (agent.mcs.yml, topics/, actions/, knowledge/, variables/, agents/) and discovery patterns to avoid hardcoded names.
  • Schema and connector lookup guidance: Documents how to use the bundled schema-lookup and connector-lookup scripts to explore definitions, resolve $refs, validate YAML, and inspect connector operations and I/O.
  • Skill-first development rules: Encourages invoking specialized skills for creating topics, actions, and validation to prevent hallucinated kinds and missing required fields.
  • Use Case: When adding a new connector action, use connector lookup to find required inputs, create the action YAML in the correct folder, and run the schema lookup validation before committing.

Quick Start

Run the schema lookup and connector lookup scripts to explore and validate new agent YAML files before adding topics or actions to the project.

Frequently Asked Questions about int-project-context

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate Copilot Studio agent YAML to prevent schema and routing errors?▼

To validate Copilot Studio agent YAML, use bundled schema-lookup and connector-lookup scripts to explore definitions, resolve $refs, and inspect connector operations. This ensures schema validation and skill-invocation conventions are followed, preventing invalid YAML and routing errors before committing changes.

What is the expected project structure for Copilot Studio agent YAML files?▼

The expected project structure for Copilot Studio agents includes agent.mcs.yml alongside topics/, actions/, knowledge/, variables/, and agents/ directories. This layout defines discovery patterns to avoid hardcoded names, allowing authors and tools to reliably maintain agent YAML.

How do I find required inputs when adding a new connector action to agent YAML?▼

To find required inputs for a new connector action, use the connector-lookup script to inspect connector operations and I/O. This guides creating the action YAML in the correct folder before running schema lookup validation for Copilot Studio projects.

Can I use specialized skills for creating topics and actions instead of manual YAML editing?▼

Yes, skill-first development rules encourage invoking specialized skills for creating topics, actions, and validation. This approach prevents hallucinated kinds and missing required fields when authoring or editing Copilot Studio agent YAML.

Why do my Copilot Studio agent routing conventions fail during YAML validation?▼

Agent routing conventions fail during YAML validation when skill-invocation conventions and ID generation patterns are not followed. Apply project context guidance to ensure schema validation, connector operation discovery, and correct file structure to prevent routing errors.

Related Skills

Explore More Software Engineering Skills→
javiarmestojaviarmesto

int-reference

Reference Copilot Studio YAML syntax for triggers, actions, variables, entities, Power Fx functions, and templates.

Community
Basic
javiarmestojaviarmesto

int-project-context

Manage YAML schemas and lookup connectors for Copilot Studio agents.

Community
Intermediate
lagz0nelagz0ne
2

using-superpowers

Invoke the Skill tool to check relevant skills before responding.

Community
Basic
jmaglyjmagly
175

config-validator

Validate AIWG YAML/JSON configuration files for syntax, schema, and references.

Community
Intermediate