Skip to content

Minimal repro skill #10711

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
timotheeguerin wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Minimal repro skill #10711

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
35e8596
Minimal repro skill
timotheeguerin May 16, 2026
7ad1d69
fix spell check
timotheeguerin May 18, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
39 changes: 39 additions & 0 deletions .github/skills/minimal-repro/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
name: minimal-repro
description: >
Help create a minimal reproduction for a TypeSpec compiler or emitter bug.
Use when a user provides TypeSpec source (pasted code or a GitHub URL) and
describes an issue. Reproduces locally and reduces to a single-file repro.
---

# Minimal Reproduction

Reduce a user-reported TypeSpec bug to the smallest single `.tsp` file that still triggers the issue.

## Inputs

- TypeSpec source (pasted or GitHub URL)
- Error description (diagnostic code, message, or incorrect emitter output)

## Environment

Use `packages/samples/scratch/` as the working directory — it's gitignored and the `packages/samples` package already depends on compiler, http, rest, openapi3, versioning, json-schema, etc.

If the repro needs packages NOT in the workspace (e.g., `@azure-tools/*`), use a temp folder with `npm install` instead.

## Steps

1. **Reproduce** — Write the user's code to `packages/samples/scratch/main.tsp`, compile with `npx tsp compile main.tsp` (add `--emit <emitter>` if relevant), and confirm the same error occurs.

2. **Minimize** — Iteratively remove code (unused imports, models, properties, decorators, operations, namespaces) and re-compile after each removal. Keep only what's needed to trigger the same error. Undo any removal that makes the error disappear.

3. **Present** — Show the final minimal `.tsp`, the compile command, and the error output. Suggest pasting into a GitHub issue or the [TypeSpec Playground](https://typespec.io/playground).

4. **Cleanup** — Remove scratch files (`rm -f packages/samples/scratch/*.tsp packages/samples/scratch/tspconfig.yaml && rm -rf packages/samples/scratch/tsp-output`).

## Tips

- Most reproductions reduce to a single file with no namespaces needed.
- Remove `@service`, `@server`, `@doc`, `@info` early — they're rarely relevant.
- Combine multi-file code into one file by inlining.
- If the error doesn't reproduce, check for missing `import`/`using` statements.
Loading