discovery-design-tasks

discovery-design-tasks is a skill for Claude Code, Codex from microsoft/discovery. It costs 0 tokens per session (7,721 once invoked), scanned A, original, MIT.

A task-planning guide for Microsoft Discovery investigations, which examine questions using groups of Foundry agents. It creates a Markdown plan using fixed steps, guided exploration, autonomous research, or a combination.

In plain words
What is it for?
Use it to plan a Discovery investigation, design tasks for local or cloud-based agent groups, or choose an investigation pattern. It produces a Markdown task-design file and does not overwrite an existing one.
Why use it?
It helps turn a broad investigation request into an organized task tree and choose a suitable investigation approach. For cloud services, it also describes how to locate the relevant workspace, project, agents, or task.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/microsoft/discovery/discovery-design-tasks
Any agent
npx skills add microsoft/discovery --skill discovery-design-tasks
Clone the repo
git clone --depth 1 https://github.com/microsoft/discovery

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for discovery-design-tasks

README.md
[![agentmods](https://agentmods.dev/badge/skills/microsoft/discovery/discovery-design-tasks.svg)](https://agentmods.dev/skills/microsoft/discovery/discovery-design-tasks)
Your own site
<a href="https://agentmods.dev/skills/microsoft/discovery/discovery-design-tasks"><img src="https://agentmods.dev/badge/skills/microsoft/discovery/discovery-design-tasks.svg" alt="Measured on agentmods" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 7,721 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.07721
Opus 5 $0.00000 $0.03861
Sonnet 5 $0.00000 $0.01544
Haiku 4.5 $0.00000 $0.00772

Measured 4d ago against content hash 049df94ad962, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

discovery-design-tasks scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.github/skills/discovery-design-tasks/SKILL.md · 380 lines

How it starts

The opening of the file, as written. The whole thing — 380 lines — stays where its author put it; the contents beside it link to each section on GitHub.

​--- name: discovery-design-tasks description: "Generate a Microsoft Discovery task design (markdown only) for a user-specified local-app or cloud-service Foundry agent set using one (or all) of the three advanced investigation patterns: Deterministic, Guided Exploration, and Autonomous Research. For cloud-service task design or task creation, first look for a Discovery MCP server or Discovery proxy to resolve cloud workspaces, projects, agents, investigations, and tasks; if none is available, try Azure CLI before asking the user for another access route. Use when asked to plan a Discovery investigation, draft task trees, or choose an investigation pattern for an existing agent set." argument-hint: "Optional: --target local|cloud --agents all|select --pattern deterministic|guided|autonomous|all --out " user-invocable: true

Discovery Task Design

This skill produces a markdown task design file and must never overwrite an existing task-design.md.

What This Skill Does

Generates a task-design.md document that describes a Discovery investigation using one or all of the three patterns from the Microsoft Discovery advanced investigation patterns documentation:

  • Deterministic Investigation — fully specified parent + numbered subtasks with explicit agents and dependencies.
  • Guided Exploration — high-level phases with broad validation; cognition picks agents inside each phase.
  • Autonomous Research — single root-task prompt with validation requirements only.

The full canonical markdown example is embedded in Appendix A at the bottom of this file — use it as the byte-for-byte structural reference.

Inputs to Collect

Before generating anything, gather these inputs (use the ask-questions tool if any are missing or ambiguous — do NOT guess). Reuse values already present in the conversation or active editor when possible. Collect the Discovery target first by itself; if the user chooses Discovery cloud service, ask the cloud workspace, project, and investigation name in the next question before asking for the objective, pattern, or output folder.

Read the full file on GitHub · 380 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 380 lines · 0 tokens per session scan A 049df94ad962

Subscribe to this mod's changes

discovery-design-tasks is a skill published in the GitHub repository microsoft/discovery (235 stars, last pushed today), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 7,721 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes.

obra/superpowers · 21 tokens

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.

obra/superpowers · 37 tokens

auto-perf-optimize

Run agent-driven VS Code performance or memory investigations. Use when asked to launch Code OSS, automate a VS Code scenario, run the Chat memory smoke runner, capture renderer heap snapshots, take workflow screenshots, compare run summaries, or drive a repeatable scenario before heap-snapshot analysis.

microsoft/vscode · 62 tokens

chat-perf

Run chat perf benchmarks and memory leak checks against the local dev build or any published VS Code version. Use when investigating chat rendering regressions, validating perf-sensitive changes to chat UI, or checking for memory leaks in the chat response pipeline.

microsoft/vscode · 51 tokens

chat-pet-sprite-creation

Use when creating or changing VS Code chat pet sprite art, sprite sheets, state animations, eye treatments, Stable/Insiders variants, or pet transitions under src/vs/workbench/contrib/chat/browser/widget/media/chatPet.

microsoft/vscode · 53 tokens

cpu-profile-analysis

Analyze V8/Chrome CPU profiles (.cpuprofile) and DevTools trace files (Trace-.json). Use when: profiling performance, investigating slow functions, comparing code paths, finding bottlenecks, analyzing timeToRequest, understanding call trees from sampling profiler data, analyzing layout/paint/rendering, investigating…

microsoft/vscode · 71 tokens