Ecs Rfc Guide
elastic/ecs
Guides contributors through the Elastic Common Schema (ECS) RFC (Proposal) process: template sections, target maturity (alpha/beta), rfcs/text artifacts, and optional OTel mapping.
Inspect local Aspire resource health, logs, traces, and browser telemetry.
Install Aspire Diagnostics
$ npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install exceptionless/Exceptionless aspire-diagnostics --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/exceptionless/Exceptionless.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/aspire-diagnostics .claude/skills/aspire-diagnostics && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "aspire-diagnostics" agent skill from https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnostics into .claude/skills/aspire-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-diagnostics", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnosticsType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install exceptionless/Exceptionless aspire-diagnostics --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/exceptionless/Exceptionless.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.agents/skills/aspire-diagnostics .agents/skills/aspire-diagnostics && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "aspire-diagnostics" agent skill from https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnostics into .agents/skills/aspire-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-diagnostics", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install exceptionless/Exceptionless aspire-diagnostics --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/exceptionless/Exceptionless.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.agents/skills/aspire-diagnostics .cursor/skills/aspire-diagnostics && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "aspire-diagnostics" agent skill from https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnostics into .cursor/skills/aspire-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-diagnostics", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/exceptionless/Exceptionless.git --path .agents/skills/aspire-diagnostics--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install exceptionless/Exceptionless aspire-diagnostics --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/exceptionless/Exceptionless.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.agents/skills/aspire-diagnostics .gemini/skills/aspire-diagnostics && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "aspire-diagnostics" agent skill from https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnostics into .gemini/skills/aspire-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-diagnostics", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install exceptionless/Exceptionless aspire-diagnosticsInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/exceptionless/Exceptionless.git skills-src && mkdir -p .github/skills && cp -r skills-src/.agents/skills/aspire-diagnostics .github/skills/aspire-diagnostics && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "aspire-diagnostics" agent skill from https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnostics into .github/skills/aspire-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-diagnostics", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install exceptionless/Exceptionless aspire-diagnostics --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/exceptionless/Exceptionless.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.agents/skills/aspire-diagnostics .opencode/skills/aspire-diagnostics && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "aspire-diagnostics" agent skill from https://github.com/exceptionless/Exceptionless/tree/main/.agents/skills/aspire-diagnostics into .opencode/skills/aspire-diagnostics/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "aspire-diagnostics", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
aspire-diagnostics- GitHub stars
- 2.5k
- Token cost
- ~769 tokens
- SKILL.md length
- 380 words
- Files
- 1
- Skills in repo
- 11
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Inspect local Aspire resource health, logs, traces, and browser telemetry.
- Works in 5 steps: Record the app URL, resource names,… → Locate its trace and inspect spans for… → Count calls by dependency and operation,… → …
- DevOps & Cloud work in your project
- SKILL.md covers Diagnose the affected operation, Performance investigation and Browser and environment…
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Aspire Diagnostics is an agent skill from exceptionless/Exceptionless. Inspect local Aspire resource health, logs, traces, and browser telemetry.
Its SKILL.md is about 770 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in DevOps & Cloud. It works with Elasticsearch, Redis and OpenTelemetry. The repository describes itself as: Exceptionless application. The licence is Apache-2.0.
When your agent uses it
- DevOps & Cloud work in your project
Example prompts
- “/aspire-diagnostics”
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- Record the app URL, resource names, action, and timestamp; perform the action once.
- Locate its trace and inspect spans for repeated API requests, Elasticsearch searches, Redis operations, queue publishes, and job processing.
- Count calls by dependency and operation, identify slow spans, and correlate errors with structured logs. Distinguish retries from…
- Use dashboard metrics for aggregate request counts, error rates, and latency trends. A single trace describes that request, not the…
- Export telemetry when a deeper comparison or report needs the evidence preserved.
What it can do on your machine
Read from SKILL.md and the folder at commit 300e8ca. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Aspire Diagnostics loads about 769 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 380 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from exceptionless/Exceptionless at commit 300e8ca, republished under its Apache-2.0 licence (© exceptionless). 380 words, ~769 tokens.
Download SKILL.mdSave it as
.claude/skills/aspire-diagnostics/SKILL.md (or your agent's skills folder).- name
- aspire-diagnostics
- description
- Inspect local Aspire resource health, logs, traces, and browser telemetry.
Aspire Diagnostics
Use runtime evidence to diagnose a local failure or measure an affected operation. Follow root AGENTS.md for runtime startup and endpoint scope.
From the repository root, select this AppHost explicitly:
aspire describe --apphost src/Exceptionless.AppHost --format Json --non-interactiveUse the reported resource names and endpoints. Add --include-hidden when a resource is not listed.
| Evidence | Command |
|---|---|
| Structured logs | aspire otel logs <resource> --limit 100 --format Json --non-interactive |
| Process output | aspire logs <resource> --tail 100 --timestamps --non-interactive |
| Recent traces | aspire otel traces --limit 20 --format Json --non-interactive |
| Trace spans | aspire otel spans <resource> --trace-id <traceId> --format Json --non-interactive |
| Export | aspire export --output ./dogfood-output/aspire-telemetry.zip --non-interactive |
Diagnose the affected operation
Start with resource health and the reported failure. Prefer structured logs for application errors and contextual fields; use console logs for startup failures, crashes, and other process output. Use traces when the failure or latency crosses API, queue, job, or storage boundaries, then inspect the relevant spans.
Correlate evidence with the user action, timestamp, resource, and trace ID. For a known trace, inspect related logs with aspire otel logs --trace-id <traceId> --format Json --non-interactive. A healthy resource alone does not establish that the operation succeeded.
Show full SKILL.md (195 more words)Show less
Performance investigation
- Record the app URL, resource names, action, and timestamp; perform the action once.
- Locate its trace and inspect spans for repeated API requests, Elasticsearch searches, Redis operations, queue publishes, and job processing.
- Count calls by dependency and operation, identify slow spans, and correlate errors with structured logs. Distinguish retries from duplicate work.
- Use dashboard metrics for aggregate request counts, error rates, and latency trends. A single trace describes that request, not the workload's overall performance.
- Export telemetry when a deeper comparison or report needs the evidence preserved.
Report the exact action, resource names, trace IDs, repeated-call counts, durations, and relevant errors. State any missing telemetry that limits the conclusion.
Browser and environment boundaries
The AppHost enables WithBrowserLogs() for the Svelte App resource, which serves the application at /. Discover that resource's current endpoint. Use its dashboard for browser console/network evidence or screenshots when they explain a UI failure, and correlate browser activity with backend traces where available.
Avoid restarting the whole AppHost as a diagnostic loop. For deployed or external environments, follow the user's explicit scope and the platform's diagnostics; do not assume local Aspire commands or endpoints apply.
© exceptionless, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .agents/skills/aspire-diagnostics of exceptionless/Exceptionless.
Open the folder on GitHubat commit 300e8ca
Compare with similar skills
Aspire Diagnostics next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Aspire Diagnostics this skillexceptionless/Exceptionless | 2.5k | — | ~769 | Automated safety check: Pass | Apache-2.0 | |
| Ecs Rfc Guideelastic/ecs | 1.1k | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| UModel Root Cause Analysisalibaba/UnifiedModel | 412 | — | ~1.9k | Automated safety check: Pass | Custom licence | |
| Proto Backend Moduleaide-family/moon | 253 | — | ~4.1k | Automated safety check: Pass | None | |
| Observability Onboardingelastic/agent-skills | 592 | — | ~4.1k | Automated safety check: Pass | Apache-2.0 | |
| Observability K8s Investigationelastic/agent-skills | 592 | — | ~8.3k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
UModel Root Cause Analysis
alibaba/UnifiedModel
Investigates a service incident to its root cause by querying a UModel object graph alongside metrics, logs, topology and recent deployments.
Proto Backend Module
aide-family/moon
Implements backend modules from proto definitions for goddess, marksman, and rabbit apps.
- Official
Observability Onboarding
elastic/agent-skills
Onboard an application into Elastic Observability with the Elastic Distribution of OpenTelemetry (EDOT): route on language and runtime, detect and replace a classic Elastic APM agent, apply the…
- Official
Observability K8s Investigation
elastic/agent-skills
Investigate Kubernetes workload, node, and control-plane issues using OTel telemetry (EDOT).
Aspireify
CommunityToolkit/Aspire
WORKFLOW SKILL - Wire Aspire AppHosts or repair TypeScript AppHost toolchains.
More from exceptionless/Exceptionless
All 11 skills in this repoEmil Design Eng
exceptionless/Exceptionless
This skill encodes Emil Kowalski's philosophy on UI polish, component design, animation decisions, and the invisible details that make software feel great.
Shadcn Svelte
exceptionless/Exceptionless
Manages shadcn-svelte components and projects — adding, updating, fixing, debugging, styling, and composing UI.
Dogfood
exceptionless/Exceptionless
Systematically dogfood Exceptionless locally. An agent skill from exceptionless/Exceptionless.
Foundatio Repositories
exceptionless/Exceptionless
Query, aggregate, patch, or paginate Exceptionless data through its Elasticsearch repository abstractions.
Releasenotes
exceptionless/Exceptionless
Evaluate semantic-version impact and generate formatted changelogs from git history since the last release tag.
Tanstack Form
exceptionless/Exceptionless
Build Svelte forms with TanStack Form, Zod validation, and API error mapping.
Related
Works with
Categories
Questions about Aspire Diagnostics
What does Aspire Diagnostics do?
Inspect local Aspire resource health, logs, traces, and browser telemetry. Aspire Diagnostics is an agent skill from exceptionless/Exceptionless. Inspect local Aspire resource health, logs, traces, and browser telemetry.
When should I use Aspire Diagnostics?
Aspire Diagnostics fits situations like: devOps & Cloud work in your project.
How do I install Aspire Diagnostics in Claude Code?
Run `npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a claude-code`. Or copy the skill folder (.agents/skills/aspire-diagnostics in exceptionless/Exceptionless) into .claude/skills/aspire-diagnostics in your project. Claude Code loads it when a task matches its description.
How do I install Aspire Diagnostics in Codex?
Run `npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a codex`. Or copy the skill folder (.agents/skills/aspire-diagnostics in exceptionless/Exceptionless) into .agents/skills/aspire-diagnostics in your project. Codex loads it when a task matches its description.
Can I use Aspire Diagnostics in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add exceptionless/Exceptionless --skill aspire-diagnostics -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/aspire-diagnostics, .gemini/skills/aspire-diagnostics, .github/skills/aspire-diagnostics and .opencode/skills/aspire-diagnostics in your project.
What does Aspire Diagnostics need to run?
SKILL.md names no scripts, command-line tools or credentials: Aspire Diagnostics is instructions for the agent only.
Does Aspire Diagnostics access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Aspire Diagnostics safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Aspire Diagnostics use?
Aspire Diagnostics is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Aspire Diagnostics use?
About 769 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Aspire Diagnostics?
Skills that share tags, products or a category with Aspire Diagnostics: Ecs Rfc Guide (elastic/ecs, 1.1k stars), UModel Root Cause Analysis (alibaba/UnifiedModel, 412 stars), Proto Backend Module (aide-family/moon, 253 stars) and Observability Onboarding (elastic/agent-skills, 592 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Aspire Diagnostics?
exceptionless (a GitHub organization) maintains it in exceptionless/Exceptionless, which has 2,456 GitHub stars. The repository holds 11 skills in this directory. The repository was last updated on October 6, 2026.
Source: exceptionless/Exceptionless on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.