Skip to content

BumpyClock/agent-templates / skills/programming

programming

Unverified

Implement, debug, refactor, or review code with scoped changes and evidence.

FileKindSize
SKILL.mdskill md9.3 KB
agents/openai.yamlconfig225 B
attribution.txtmarkdown3.4 KB
references/apple/guide.mdmarkdown4.6 KB
references/apple/upstream/adopt-c-bounds-safety/guide.mdmarkdown1.2 KB
references/apple/upstream/adopt-c-bounds-safety/references/adoption-strategies.mdmarkdown12.0 KB
references/apple/upstream/adopt-c-bounds-safety/references/build-settings.mdmarkdown2.9 KB
references/apple/upstream/adopt-c-bounds-safety/references/common-patterns-and-pitfalls.mdmarkdown35.3 KB
references/apple/upstream/adopt-c-bounds-safety/references/language-overview.mdmarkdown39.3 KB
references/apple/upstream/adopt-c-bounds-safety/references/runtime-debugging.mdmarkdown8.7 KB
references/apple/upstream/app-intents-specialist/guide.mdmarkdown2.1 KB
references/apple/upstream/app-intents-specialist/references/app-enum.mdmarkdown4.9 KB
references/apple/upstream/app-intents-specialist/references/app-shortcut-phrases.mdmarkdown9.2 KB
references/apple/upstream/app-intents-specialist/references/configuration-intents.mdmarkdown5.2 KB
references/apple/upstream/app-intents-specialist/references/dependencies.mdmarkdown8.2 KB
references/apple/upstream/app-intents-specialist/references/donation.mdmarkdown3.5 KB
references/apple/upstream/app-intents-specialist/references/entities-and-queries.mdmarkdown10.5 KB
references/apple/upstream/app-intents-specialist/references/entity-property-queries.mdmarkdown9.4 KB
references/apple/upstream/app-intents-specialist/references/execution-model.mdmarkdown8.6 KB
references/apple/upstream/app-intents-specialist/references/factoring.mdmarkdown6.9 KB
references/apple/upstream/app-intents-specialist/references/localization.mdmarkdown6.4 KB
references/apple/upstream/app-intents-specialist/references/parameter-summaries.mdmarkdown8.1 KB
references/apple/upstream/app-intents-specialist/references/parameters.mdmarkdown8.5 KB
references/apple/upstream/app-intents-specialist/references/results-and-errors.mdmarkdown5.1 KB
references/apple/upstream/app-intents-specialist/references/url-representation.mdmarkdown9.5 KB
references/apple/upstream/app-intents-whats-new-27/guide.mdmarkdown1.9 KB
references/apple/upstream/app-intents-whats-new-27/references/convenience-properties.mdmarkdown6.6 KB
references/apple/upstream/app-intents-whats-new-27/references/cross-device-and-ownership.mdmarkdown7.8 KB
references/apple/upstream/app-intents-whats-new-27/references/entity-collection.mdmarkdown8.7 KB
references/apple/upstream/app-intents-whats-new-27/references/execution-modes.mdmarkdown10.6 KB
references/apple/upstream/app-intents-whats-new-27/references/interactive-snippets.mdmarkdown13.9 KB
references/apple/upstream/app-intents-whats-new-27/references/onscreen-entities.mdmarkdown6.5 KB
references/apple/upstream/app-intents-whats-new-27/references/relevance-and-context.mdmarkdown6.8 KB
references/apple/upstream/app-intents-whats-new-27/references/requestchoice.mdmarkdown5.4 KB
references/apple/upstream/app-intents-whats-new-27/references/schema-adoption.mdmarkdown14.9 KB
references/apple/upstream/app-intents-whats-new-27/references/spotlight-indexing.mdmarkdown7.1 KB
references/apple/upstream/app-intents-whats-new-27/references/system-shortcuts.mdmarkdown3.1 KB
references/apple/upstream/app-intents-whats-new-27/references/testing.mdmarkdown14.9 KB
references/apple/upstream/app-intents-whats-new-27/references/union-values.mdmarkdown10.0 KB
references/apple/upstream/app-intents-whats-new-27/references/visual-intelligence.mdmarkdown6.2 KB
references/apple/upstream/audit-xcode-security-settings/guide.mdmarkdown6.9 KB
references/apple/upstream/audit-xcode-security-settings/references/additional-settings.mdmarkdown1016 B
references/apple/upstream/audit-xcode-security-settings/references/adoption-strategy.mdmarkdown4.3 KB
references/apple/upstream/audit-xcode-security-settings/references/cpp-hardening.mdmarkdown3.5 KB
references/apple/upstream/audit-xcode-security-settings/references/decision-document.mdmarkdown3.0 KB
references/apple/upstream/audit-xcode-security-settings/references/enhanced-security.mdmarkdown8.2 KB
references/apple/upstream/audit-xcode-security-settings/references/hardware-memory-tagging.mdmarkdown3.8 KB
references/apple/upstream/audit-xcode-security-settings/references/pointer-authentication.mdmarkdown6.6 KB
references/apple/upstream/audit-xcode-security-settings/references/reading-build-settings.mdmarkdown5.7 KB
references/apple/upstream/audit-xcode-security-settings/references/readonly-platform-memory.mdmarkdown2.5 KB
references/apple/upstream/audit-xcode-security-settings/references/runtime-restrictions.mdmarkdown2.8 KB
references/apple/upstream/audit-xcode-security-settings/references/security-compiler-warnings.mdmarkdown3.2 KB
references/apple/upstream/audit-xcode-security-settings/references/security-settings-reference.mdmarkdown10.0 KB
references/apple/upstream/audit-xcode-security-settings/references/stack-zero-init.mdmarkdown1.9 KB
references/apple/upstream/audit-xcode-security-settings/references/typed-allocators.mdmarkdown3.2 KB
references/apple/upstream/audit-xcode-security-settings/references/universal-binaries-for-libraries.mdmarkdown5.2 KB
references/apple/upstream/audit-xcode-security-settings/scripts/filter_build_settings.pyexecutablescript2.4 KB
references/apple/upstream/building-document-based-swiftui-applications/guide.mdmarkdown1.1 KB
references/apple/upstream/building-document-based-swiftui-applications/references/creating-document-apps.mdmarkdown34.0 KB
references/apple/upstream/building-document-based-swiftui-applications/references/migrating-document-apps.mdmarkdown12.1 KB
references/apple/upstream/building-document-based-swiftui-applications/references/uniform-type-identifiers.mdmarkdown5.2 KB
references/apple/upstream/device-interaction/guide.mdmarkdown11.4 KB
references/apple/upstream/modernize-tests/guide.mdmarkdown9.5 KB
references/apple/upstream/swiftui-specialist/guide.mdmarkdown1.2 KB
references/apple/upstream/swiftui-specialist/references/animations.mdmarkdown2.7 KB
references/apple/upstream/swiftui-specialist/references/dataflow.mdmarkdown32.1 KB
references/apple/upstream/swiftui-specialist/references/environment.mdmarkdown39.1 KB
references/apple/upstream/swiftui-specialist/references/foreach.mdmarkdown21.8 KB
references/apple/upstream/swiftui-specialist/references/localization.mdmarkdown11.3 KB
references/apple/upstream/swiftui-specialist/references/modifiers.mdmarkdown4.4 KB
references/apple/upstream/swiftui-specialist/references/soft-deprecated-apis.mdmarkdown32.6 KB
references/apple/upstream/swiftui-specialist/references/soft-deprecation.mdmarkdown1.5 KB
references/apple/upstream/swiftui-specialist/references/structure.mdmarkdown11.4 KB
references/apple/upstream/swiftui-whats-new-27/guide.mdmarkdown1.2 KB
references/apple/upstream/swiftui-whats-new-27/references/async-image.mdmarkdown4.0 KB
references/apple/upstream/swiftui-whats-new-27/references/content-builder.mdmarkdown15.9 KB
references/apple/upstream/swiftui-whats-new-27/references/item-binding.mdmarkdown5.2 KB
references/apple/upstream/swiftui-whats-new-27/references/reorderable.mdmarkdown9.3 KB
references/apple/upstream/swiftui-whats-new-27/references/state-macro.mdmarkdown3.1 KB
references/apple/upstream/swiftui-whats-new-27/references/swipe-actions.mdmarkdown3.3 KB
references/apple/upstream/swiftui-whats-new-27/references/toolbar.mdmarkdown6.8 KB
references/apple/upstream/uikit-app-modernization/guide.mdmarkdown2.6 KB
references/apple/upstream/uikit-app-modernization/references/orientation-task.mdmarkdown4.1 KB
references/apple/upstream/uikit-app-modernization/references/safe-area-task.mdmarkdown6.4 KB
references/apple/upstream/uikit-app-modernization/references/scene-lifecycle-task.mdmarkdown10.2 KB
references/apple/upstream/uikit-app-modernization/references/uiscreen-task.mdmarkdown29.5 KB
references/architecture/architecture-planning.mdmarkdown1.8 KB
references/design/type-design.mdmarkdown1.3 KB
references/error-handling/silent-failures.mdmarkdown1.5 KB
references/gpui/guide.mdmarkdown2.1 KB
references/gpui/references/actions.mdmarkdown2.1 KB
references/gpui/references/async.mdmarkdown3.1 KB
references/gpui/references/component-test-rules.mdmarkdown582 B
references/gpui/references/context.mdmarkdown1.0 KB
references/gpui/references/element.mdmarkdown2.1 KB
references/gpui/references/entity.mdmarkdown2.4 KB
references/gpui/references/event.mdmarkdown2.3 KB
references/gpui/references/focus-handle.mdmarkdown2.3 KB
references/gpui/references/generate-component-documentation.mdmarkdown659 B
references/gpui/references/generate-component-story.mdmarkdown679 B
references/gpui/references/global.mdmarkdown1.7 KB
references/gpui/references/layout-and-style.mdmarkdown2.0 KB
references/gpui/references/new-component.mdmarkdown766 B
references/gpui/references/style-guide.mdmarkdown2.8 KB
references/gpui/references/test-examples.mdmarkdown936 B
references/gpui/references/test-reference.mdmarkdown3.9 KB
references/gpui/references/test.mdmarkdown920 B
references/languages/typescript-patterns.mdmarkdown3.6 KB
references/performance/perf-issue.mdmarkdown4.8 KB
references/performance/runtime-forensics.mdmarkdown4.0 KB
references/performance/trace-forensics.mdmarkdown4.5 KB
references/refactoring/clean-refactoring.mdmarkdown3.7 KB
references/web-development.mdmarkdown2.5 KB
references/winui/guide.mdmarkdown2.0 KB
references/winui/references/winui-code-review/guide.mdmarkdown2.5 KB
references/winui/references/winui-code-review/references/quality-rules.mdmarkdown10.6 KB
references/winui/references/winui-design/guide.mdmarkdown10.2 KB
references/winui/references/winui-design/references/brushes-and-icons.mdmarkdown12.1 KB
references/winui/references/winui-design/references/layout-review.mdmarkdown2.1 KB
references/winui/references/winui-design/references/theme-accessibility.mdmarkdown3.8 KB
references/winui/references/winui-dev-workflow/BuildAndRun.ps1script6.4 KB
references/winui/references/winui-dev-workflow/analyzer/Microsoft.WindowsAppSDK.Analyzers.dllbinary48.5 KB
references/winui/references/winui-dev-workflow/analyzer/Microsoft.WindowsAppSDK.Analyzers.targetsother547 B
references/winui/references/winui-dev-workflow/guide.mdmarkdown6.3 KB
references/winui/references/winui-packaging/guide.mdmarkdown2.9 KB
references/winui/references/winui-packaging/references/package-examples.mdmarkdown3.8 KB
references/winui/references/winui-packaging/references/sourcegen-patterns.mdmarkdown3.7 KB
references/winui/references/winui-setup/guide.mdmarkdown1.7 KB
references/winui/references/winui-setup/references/setup-examples.mdmarkdown2.1 KB
references/winui/references/winui-ui-testing/guide.mdmarkdown20.9 KB
references/winui/references/winui-wpf-migration/guide.mdmarkdown2.3 KB
references/winui/references/winui-wpf-migration/references/migration-examples.mdmarkdown3.5 KB
references/workflows/feature.mdmarkdown2.4 KB

references/winui/references/winui-dev-workflow/guide.md

View on GitHub
### Create or Open a Project

Use this guide to create, build, launch, or diagnose WinUI 3 apps with WinApp CLI.

**New app** — let WinApp CLI install/update the official templates and scaffold:
```powershell
winapp new --name <AppName> --template winui-mvvm --template-version latest --use-defaults
cd <AppName>
```
Run `winapp new --list` to discover the currently installed template short names. Do not install the template pack separately and do not create the output directory first.

**Existing app** — read the `.csproj` to understand:
- `<TargetFramework>` (e.g., `net10.0-windows10.0.26100.0`)
- `<PackageReference>` versions (WindowsAppSDK, CommunityToolkit)
- Project structure and established patterns

### Install Packages

```powershell
dotnet add package <Name>
```
Preserve repository version pins and compatibility requirements.
Select an explicit compatible version when needed. A newer package is not inherently compatible with the project.

### Build & Run

WinApp CLI 0.6+ builds a `.csproj` and launches it directly:

```powershell
winapp run . --debug-output
winapp run .\MyApp.csproj -c Release --arch arm64
```

Use the repository command when available.
The included `BuildAndRun.ps1` invokes project-mode `winapp run`, injects the bundled analyzer, and enables `--debug-output` by default:

```powershell
.\BuildAndRun.ps1
```

Use the current harness process-session mechanism for attached runs.
The command stays attached while the app is open. Capture the app PID for later inspection.
Project-mode launch can register a development package. Use a build-only command when launch or registration is outside the task.

The wrapper only adds repository-specific analyzer and debug defaults. WinApp CLI handles:
1. Project restore and build
2. Configuration, architecture, runtime, and framework selection
3. Packaged versus unpackaged detection
4. Build-output and executable discovery
5. Windows App Runtime setup
6. Package registration and launch

**Options and forwarded WinApp arguments:**
```
.\BuildAndRun.ps1                              # one top-level csproj; attached diagnostics
.\BuildAndRun.ps1 .\MyApp.csproj               # explicit project
.\BuildAndRun.ps1 .\MyApp.csproj -c Release    # forwarded to winapp run
.\BuildAndRun.ps1 .\MyApp.csproj --arch arm64  # forwarded to winapp run
.\BuildAndRun.ps1 . --detach --json             # return after launch; emit PID as JSON
.\BuildAndRun.ps1 . --symbols                   # add Symbol Server-backed native symbols
.\BuildAndRun.ps1 --args "--flag value"         # pass application arguments
```

The wrapper accepts the same `.csproj`, `.sln`/`.slnx`, directory, and `--project` inputs as `winapp run`.

For build failures, identify the cause before changes or retries.
For an implementation task, correct failures caused by the change and rerun affected checks.

For launch crashes, inspect captured process output and the stowed-exception diagnostics below.

### Diagnosing Crashes with `winapp run`

For WinUI apps, `--debug-output` (the wrapper default) runs a **stowed-exception triage** on crash, surfacing the real WinUI/XAML error behind an opaque `0x8000FFFF` / `E_FAIL`. The first crash downloads debugger components and can take a few minutes; point `WINAPP_DBGTOOLS_DIR` at an existing *Debugging Tools for Windows* install for offline/locked-down environments. Add `--symbols` for richer native frames.

### Common Errors

| Error | Fix |
|-------|-----|
| Developer Mode not enabled | Check whether the requested activation path requires it. Obtain approval before the machine-wide change |
| CS0234/CS0246 missing type | Add `using` or `dotnet add package` |
| NETSDK1136 platform required | Target a Windows TFM (for example `net10.0-windows10.0.26100.0`); use `-f <windows-tfm>` when the project already multi-targets |
| XLS0414 XAML type not found | Add `xmlns` declaration |
| XDG0062 binding path missing | Check `x:Bind` property exists on ViewModel |
| Blank window after launch | Inspect activation errors and binding sources. Use `OneWay` only when the source must update the target |
| App silently exits | Capture launch diagnostics and check the intended packaged or unpackaged activation path |
| App crashes with opaque `0x8000FFFF` / `E_FAIL` | Run under `--debug-output` (BuildAndRun.ps1 default) — WinUI stowed-exception triage surfaces the real XAML error + symbolicated native stack. `--symbols` is optional |
| XAML compiler crashes silently | Remove any `PresentationCore.dll` / `System.Windows` references |
| MSB3073 / `XamlCompiler.exe ... exited with code 1`, no `.xaml` named | Inspect the build log and resolved SDK version. Confirm a matching SDK defect before an upgrade |
| 0x80073CF6 package install failed | Check the manifest publisher and Developer Mode; apps from `winapp new` need no separate `winapp init` |
| 0x80073CF9 / "Failed to reach state Staged" on a deeply nested project | Check path length and package layout. For a confirmed path issue, use a shorter dedicated `--output-appx-directory`. Keep layouts separate by configuration and architecture. Remove stale payloads only from confirmed disposable build output. If ownership or live registration is uncertain, use a fresh layout directory |
| 0x8007000B bad image format | Wrong platform target — use x64 or ARM64, not AnyCPU |

### Prerequisites

For missing tools or incompatible versions, consult [setup](../winui-setup/guide.md).
Read-only checks do not require a separate setup request.
Install tools only within authorized setup scope. Ask before elevation or a machine-wide Developer Mode change.

### Critical Rules

- Preserve the intended activation model. Use package activation for packaged apps and the supported executable path for unpackaged apps.
- Do not remove the manifest or change `WindowsPackageType` merely to bypass a launch failure.
- Match platform and runtime architecture to project dependencies. Do not assume an `AnyCPU` configuration supplies compatible native binaries.

### References

- `BuildAndRun.ps1` — included with this guide; adds the bundled analyzer and diagnostic defaults to `winapp run`
- `analyzer/Microsoft.WindowsAppSDK.Analyzers.dll` — unsigned prebuilt binary imported with microsoft/win-dev-skills plugin 0.6.0; SHA-256 `e989099a0e369a1f2c114b4d86a82789f1006d73efc719db96e9bbe45d88671c`. It runs inside the compiler when the wrapper is used.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 318kUpdated Claude CodeCodexUnverifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 318kUpdated Claude CodeCodexUnverifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 318kUpdated Claude CodeCodexUnverifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 196kUpdated Claude CodeCodexVerifiedInstall