CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

agent-introspection-debugging

キャプチャ、診断、封じ込め回復、内省レポートを使用した AI エージェント障害のための構造化された自己デバッグワークフロー。

Quality

75%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./docs/ja-JP/skills/agent-introspection-debugging/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

The body is a well-engineered, self-contained workflow: a crisp four-phase loop with explicit diagnostic validation, evidence-based recovery, and reporting templates, organized into scannable sections with a useful scope-boundary and cross-skill integration guide. Weaknesses are minor — slight redundancy in the heuristics section and a few directional rather than executable recovery instructions. It fully succeeds as an instruction-only skill.

DimensionReasoningScore

Conciseness

The body is dense and template/table-driven with no explanation of concepts Claude already knows; it earns an 'efficient, minor trimming possible' score because the 回復ヒューリスティクス section (lines 119-136) partially restates Phase 2/3 guidance and the 良いパターン list repeats the four-phase loop. Not a 5 due to that redundancy; not a 3 because there is no padded or over-explained content.

4 / 5

Actionability

Concrete, actionable guidance throughout: three copy-paste markdown templates (障害キャプチャ, 回復アクション, 自己デバッグレポート), a failure-pattern table with specific errors (ECONNREFUSED, 429, 書き込み後にファイルが見つからない) and concrete checks, and an explicit anti-hallucination rule about not claiming to reset agent state. Not a 5 because some guidance remains directional rather than executable, e.g. 「推測的な推論から直接観察に切り替える」 and the checks column gives what to verify but not how.

4 / 5

Workflow Clarity

A clearly sequenced four-phase loop (キャプチャ → 診断 → 回復 → レポート) with explicit validation checkpoints (「診断を検証する最小の可逆的アクションは何か?」), a post-recovery evidence requirement (「修正が機能したことを証明するエビデンスは何か」), a feedback-loop rule (「チェックがサポートする場合にのみ計画を変更する」), and outcome states (成功 | 部分的 | ブロック中). This matches the top anchor's 'explicit validation steps, feedback loops, and checklists'; no destructive or batch operations apply the cap.

5 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent) and the single SKILL.md is well-sectioned with clear headers, a scope-boundary section, and nothing that clearly belongs in a separate file. Not a 5: at ~150 lines with three inline templates it exceeds the under-50-line simple-skill exception and content is not split across files; not a 3: organization is good and no inline content is clearly misplaced.

4 / 5

Total

17

/

20

Passed

Description

58%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.

The description communicates a clear, distinct capability with four named workflow phases, but it omits any explicit 'when to use' trigger guidance and lacks the natural trigger phrases (loops, repeated retries, token burn) that would let a user or Claude reliably select it. Specificity and distinctiveness are solid; completeness and trigger-term coverage are the weak points.

Suggestions

Add an explicit trigger clause to the description, e.g. 「エージェントがループしている、リトライを繰り返す、進展なくトークンを消費している、またはタスクから逸脱している場合に使用。」to answer 'when should this be used' directly.

Include natural user-facing trigger terms and synonyms such as "stuck in a loop", "repeated tool calls", "retry storm", "コンテキスト溢れ", "デバッグ" so the description matches how users actually describe the problem.

State the concrete artifacts the skill produces (障害キャプチャ、診断、回復チェックリスト、内省レポート) in more operational language to sharpen specificity toward a 5.

DimensionReasoningScore

Specificity

The description names a clear domain ("AI エージェント障害" / structured self-debugging) and lists four actions ("キャプチャ、診断、封じ込め回復、内省レポート"), matching the 'several specific actions with minor gaps' anchor. It is not a 5 because the actions are process-phase labels rather than fully concrete operations like the 'extract text, fill forms, merge documents' example.

4 / 5

Completeness

The 'what' is clearly stated (structured self-debugging workflow for AI agent failures with four named phases), but there is no 'Use when...' clause or equivalent explicit trigger guidance in the description, which caps completeness at 3 per the judging guidelines. The failure context is only weakly implied by 'AI エージェント障害'.

3 / 5

Trigger Term Quality

Terms like "AI エージェント", "障害", and "自己デバッグ" are relevant and natural, but common variations a user would actually say — stuck in a loop, repeated retries, agent going in circles, token waste — are absent. This lands at 'some relevant keywords but missing common variations or synonyms' rather than good coverage.

3 / 5

Distinctiveness Conflict Risk

"エージェント障害のための構造化された自己デバッグワークフロー" carves out a mostly distinct niche (agent self-debugging with introspection reports) with only minor overlap risk against general debugging or verification skills. It is not a 5 because without explicit trigger phrases it could still be selected for ordinary code debugging that is not an agent-failure loop.

4 / 5

Total

14

/

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

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

affaan-m/ECC

Path

docs/ja-JP/skills/agent-introspection-debugging/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.