debugging-workflows

Systematic troubleshooting for Falcon Foundry CLI errors, manifest validation failures, deploy failures, and development server issues. TRIGGER when user encounters CLI errors, `foundry ui run` not working, deploy failures, authentication issues, or any unexpected behavior during Foundry app development. Also trigger for headless/CI environment setup failures.

Quality

—

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Risky

Do not use without reviewing

Quality

Content

77%

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

A highly actionable, well-sequenced debugging reference with strong validation feedback loops. Its main weaknesses are mild redundancy between the diagnosis tree and the symptom table, and a monolithic structure that could offload detail into reference files.

Suggestions

Dedupe the overlap between the Quick Diagnosis decision tree and the Common Issue Patterns table — have one point to the other, or merge shared cases, to tighten token use.

Move the Headless / Non-Interactive Environments detail and/or the Common Issue Patterns table into a references/ file (e.g. references/headless-setup.md, references/issue-patterns.md), keeping SKILL.md as a concise overview with one-level-deep links.

Either bring the referenced e2e-testing/references/debugging-with-mcp.md into this skill's bundle as a clearly-signaled local reference, or drop the cross-skill path to avoid a dangling reference.

Dimension	Reasoning	Score
Conciseness	The body is dense and largely assumes Claude's competence, but the Quick Diagnosis decision tree and the Common Issue Patterns table overlap on several cases (login hangs, ui run on new app, deploy fails silently, auth-locally-fails-in-CI), adding redundant tokens; tightening that overlap would reach level 3.	2 / 3
Actionability	Packed with copy-paste-ready, executable commands — `foundry functions run --name my-function`, `foundry apps validate --no-prompt`, env-var exports, and a full `profile create --no-prompt` block — matching the fully-executable anchor.	3 / 3
Workflow Clarity	Multi-step procedures are clearly sequenced with validation checkpoints and feedback loops: the manifest-validation 'comment out capabilities one by one / fix and re-validate incrementally' loop, the two-phase deployment diagnostics, the 3-step install-failure isolation, and a Pre-Escalation Checklist.	3 / 3
Progressive Disclosure	Well organized into labeled sections, but it is a ~225-line monolithic file with no bundle references; the long Common Issue Patterns table and Headless setup detail are inline rather than split into one-level-deep reference files, and the single referenced path (e2e-testing/references/debugging-with-mcp.md) is not part of this skill's bundle.	2 / 3
	Total	10 / 12 Passed

Description

100%

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 that clearly states the skill's purpose and gives explicit, natural-language trigger conditions scoped to a distinct niche. It answers both 'what' and 'when' without padding or vague language.

Dimension	Reasoning	Score
Specificity	Names the Falcon Foundry domain and enumerates concrete problem categories — 'CLI errors, manifest validation failures, deploy failures, and development server issues' — matching the 'lists multiple specific concrete actions' anchor.	3 / 3
Completeness	Explicitly answers what ('Systematic troubleshooting for...') and when via an explicit 'TRIGGER when...' clause plus a secondary 'Also trigger for...' clause, satisfying the both-what-and-when anchor.	3 / 3
Trigger Term Quality	Covers natural terms users would say — 'CLI errors', 'foundry ui run not working', 'deploy failures', 'authentication issues', 'headless/CI environment setup failures' — giving broad coverage of likely user phrasings.	3 / 3
Distinctiveness Conflict Risk	Tightly scoped to CrowdStrike Falcon Foundry with product-specific triggers like 'foundry ui run', making it unlikely to fire for unrelated skills.	3 / 3
	Total	12 / 12 Passed

Validation

87%

Warnings & errors only

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

Validation — 14 / 16 Passed

Validation for skill structure

Criteria	Description	Result
metadata_version	'metadata.version' is missing	Warning
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	14 / 16 Passed

Repository: CrowdStrike/foundry-skills
Commit: 2f0ce35

Reviewed: about 23 hours ago

Table of Contents

Discovery Implementation Validation

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.