microsoft/skills/known-issues
skills/known-issues/SKILL.md
Search the known-issues knowledge base (GitHub issues labeled "kb") for symptoms, root causes, and mitigations. Use when the user reports unexpected behavior that may already have a documented fix.
$ install --global
skillsauthnpx skillsauth add microsoft/skills-for-copilot-studio skills/known-issuesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 30, 2026, 7:04 AM12.5s1 file scanned
SKILL.md
- user-invocable:
- false
- description:
- Search the known-issues knowledge base (GitHub issues labeled "kb") for symptoms, root causes, and mitigations. Use when the user reports unexpected behavior that may already have a documented fix.
- argument-hint:
- <keyword or issue number>
- allowed-tools:
- Bash(gh issue list *), Bash(gh issue view *)
Known Issues
Search the GitHub issues database for documented known issues, root causes, and mitigations.
Instructions
The known-issues database is GitHub issues labeled kb. Default repo is microsoft/skills-for-copilot-studio.
Parse $ARGUMENTS:
- If empty — list all known issues
- If a number (e.g.,
42) — view that specific issue - If a keyword or phrase — search known issues for it
- If it starts with a GitHub repo slug (
owner/repo) followed by optional keyword — use that repo
Command reference
List all known issues:
gh issue list --label kb --repo microsoft/skills-for-copilot-studio --state all --json number,title,state,body,labels,url --limit 50
Search known issues by keyword:
gh issue list --label kb --repo microsoft/skills-for-copilot-studio --state all --search "<keyword>" --json number,title,state,body,labels,url --limit 20
View a specific issue by number:
gh issue view <number> --repo microsoft/skills-for-copilot-studio --json number,title,state,body,labels,url,comments
Replace the repo if the user specified a different one.
Output format
For list and search results, present a summary table:
| # | Title | Status |
|---|-------|--------|
| 12 | Validation fails on nested ConditionGroup | Closed |
For each issue that matches the user's symptom, extract and show the structured content:
Issue #12 — Validation fails on nested ConditionGroup [CLOSED]
URL: https://github.com/microsoft/skills-for-copilot-studio/issues/12
Symptom: <from issue body>
Root Cause: <from issue body>
Mitigation: <from issue body>
Affects: <from issue body>
Prefer closed issues with mitigations — they have confirmed fixes. Flag open issues as "under investigation" or "workaround available."
After presenting results
- Match found: Share the issue number, link, and mitigation. Ask if the user wants to apply the workaround.
- No match: Tell the user no known issue matches, then continue the debugging workflow (validate YAML, check schema, etc.). Never stop here if no match is found.
Related Skills
microsoft/int-patterns
development
VerifiedTrustedCommunity
Pattern library for Copilot Studio agent design. Contains proven and recommended implementation patterns with YAML examples. Used by the Advisor agent to suggest patterns and by the Author agent to reference YAML structure during implementation. USE FOR: design guidance, pattern suggestions, review against best practices, troubleshooting known pitfalls, YAML reference during implementation. DO NOT USE FOR: general YAML schema reference (use int-reference), topic creation mechanics (use new-topic).
378SKILL.mdUpdated Jul 26, 2026
microsoft/skills/lookup-schema
testing
VerifiedTrustedCommunity
Look up Copilot Studio YAML schema definitions. Use when the user asks about schema structure, element properties, or how to use a specific YAML kind.
378SKILL.mdUpdated Apr 30, 2026
microsoft/int-reference
data-ai
VerifiedTrustedCommunity
Reference tables for Copilot Studio YAML authoring: triggers, actions, variables, entities, Power Fx functions, templates. Preloaded by author and advisor agents.
378SKILL.mdUpdated Apr 30, 2026
microsoft/skills/add-knowledge
development
VerifiedTrustedCommunity
Add a knowledge source (public website or SharePoint) to a Copilot Studio agent. Use when the user asks to add a knowledge source, documentation URL, website, or SharePoint site for the agent to search.
378SKILL.mdUpdated Apr 30, 2026