CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agentcore-investigation

Investigate Bedrock AgentCore runtime sessions via CloudWatch Logs Insights — resolve session/trace IDs, query OTEL spans, filter noise, build timelines. Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency.

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

77%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-engineered operational runbook: phased workflow with explicit limits, error-recovery loops, and mostly copy-paste-ready queries for both log-group layouts. The main flaws are broken references to non-existent mcp/ bundle files, one malformed parse line, a combined-group latency query that doesn't compute durations, and an oversized inline query catalog.

Suggestions

Fix the broken references: either ship mcp/mcp-setup.md and mcp/.mcp.json in the bundle or remove the two 'ALWAYS load' entries pointing to them — currently the primary setup path dead-ends.

Repair the combined-log-group query pair: give Query 5's parse a glob pattern (e.g. parse @message '"input_tokens":"*"' as inputTokens) and make Query 6 compute durationMs (endTimeUnixNano - startTimeUnixNano) and sort by it, matching the structured variant.

Move the combined-log-group query variants into a single reference file (e.g. references/combined-log-queries.md) and keep only the structured variants plus the layout decision table in SKILL.md, cutting roughly half the inline content.

DimensionReasoningScore

Conciseness

The body is dense and instruction-first: six query pairs expressed almost entirely as ready-to-use templates with hard limits, with no tutorial prose explaining CloudWatch or OTEL basics. Minor trimmable padding remains ("Both are normal", the Log Group Layouts paragraph that partly duplicates the table, and the Parse Syntax Guidance paragraph re-explaining regex escaping), which keeps it below the lean 5 anchor but above the mostly-efficient 3 anchor.

4 / 5

Actionability

Nearly all guidance is copy-paste-ready CloudWatch Logs Insights queries with explicit SESSION_ID/TRACE_ID placeholders, limit values, and a polling instruction ("use get_logs_insight_query_results to poll until status is Complete"). Not a 5: the combined-log-group variant of Query 5 contains a malformed parse ("parse @message '"gen_ai.usage.input_tokens"' as hasTokens" has no glob wildcard), and the combined variant of Query 6 sorts by timestamp instead of computing/sorting durationMs, so it doesn't actually surface latency outliers.

4 / 5

Workflow Clarity

A clearly sequenced Phase 0-4 pipeline (resolve trace → discover log groups → run 6 queries → filter noise → build timeline) with explicit checkpoints: query polling until Complete, a numbered filter procedure with logged output ("Filtered: {total} → {kept} spans"), a mandatory limit checklist, and an Error Handling table with feedback loops (0 results → widen range/try alternate fields; timeout → cancel/reduce/retry; structured 0 results → switch to parse queries). This is a read-only investigation, so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

Structure is present and references are well signaled with When/Contains annotations, but two of the three declared bundle files — mcp/mcp-setup.md and mcp/.mcp.json, both marked "ALWAYS load" — do not exist in the bundle, so the primary navigation path is broken. Additionally, ~150 lines of paired query templates sit inline in SKILL.md where a single reference file for the combined-log-group variants would keep the overview lean. Not a 2 because otel-span-schema.md is real, clearly signaled, and one level deep; not a 4 because missing ALWAYS-load references are more than a minor organization gap.

3 / 5

Total

16

/

20

Passed

Description

92%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: domain-specific, third-person, with four concrete capabilities and an explicit, natural-sounding 'Use when...' trigger clause. The only weakness is modest keyword coverage in the trigger phrase (missing terms like log analysis, CloudWatch, observability).

DimensionReasoningScore

Specificity

Names the domain ("Bedrock AgentCore runtime sessions via CloudWatch Logs Insights") and lists four concrete actions — "resolve session/trace IDs, query OTEL spans, filter noise, build timelines" — comparable to the 5 anchor's multiple specific concrete actions with comprehensive coverage. Not a 4 because coverage is broad for a description and each action is a distinct, verifiable capability rather than a minor gap.

5 / 5

Completeness

Explicitly answers both: what ("Investigate... resolve session/trace IDs, query OTEL spans, filter noise, build timelines") and when ("Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency") with concrete trigger phrases, matching the 5 anchor. Not a 4 because the 'when' clause is already fully explicit and specific.

5 / 5

Trigger Term Quality

"Use when debugging AgentCore agent sessions, tracing tool calls, or analyzing latency" provides natural phrases users would say. Falls short of the 5 anchor because common synonyms like "log analysis", "CloudWatch", "observability", or "spans" are absent from the trigger clause; above 3 because the included terms are natural and varied rather than generic.

4 / 5

Distinctiveness Conflict Risk

A clear niche — Bedrock AgentCore runtime session investigation via CloudWatch Logs Insights — with distinct triggers unlikely to fire for unrelated skills. Third-person voice throughout, no overlap risk with generic log or AWS skills.

5 / 5

Total

19

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 2 missing

Warning

Total

15

/

16

Passed

Repository

awslabs/mcp

Path

src/cloudwatch-mcp-server/skills/agentcore-investigation/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.