CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

collections-development

Design JSON Schema collections and CRUD patterns for Falcon Foundry apps. TRIGGER when user asks to "create a collection", "define a JSON schema", "store data in Foundry", runs `foundry collections create`, or needs help with indexable fields, FQL queries, or collection access patterns. DO NOT TRIGGER for workflow YAML, function handlers, or UI components — use the appropriate sub-skill.

Quality

87%

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

SKILL.md
Quality
Evals
Security

Quality

Content

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

Highly actionable reference content with unusually good real-world pitfalls (silent SDK validation failures, no compare-and-set, schema immutability after deploy) and genuine validation checkpoints. Its weaknesses are structural: some duplicated sections, no ordered end-to-end workflow, and two referenced use-case files that are missing from the bundle.

Suggestions

Fix the dead links: either add the `use-cases/collections.md` and `use-cases/lookup-table-enrichment.md` files or remove/replace those references — a reader following them hits nothing.

Deduplicate: the collection name/description constraints and workflow_integration YAML each appear twice (dedicated sections plus Common Pitfalls / Manifest Configuration); keep one canonical table and cross-reference it.

Add a short ordered "New collection checklist" (write schema to /tmp → check description constraints → `collections create` → verify manifest entry → wire access) so the existing validation checkpoints form an explicit sequence rather than scattered guidance.

DimensionReasoningScore

Conciseness

Nearly all content is earned, non-generic platform knowledge (limits tables, draft-7-only rule, upsert semantics, paging-by-start-key) with no tutorials on concepts Claude already knows, but there is duplication: collection name/description constraints and the workflow_integration YAML each appear in both a dedicated section and Common Pitfalls, and the 60-line TypeScript IncidentCollection class could be trimmed. Fits anchor 4 (efficient with minor trimming possible) rather than 5 or 3.

4 / 5

Actionability

Copy-paste-ready throughout: complete `foundry collections create` commands with flags, exact REST endpoints, two full valid JSON schemas, working TypeScript and falconpy Python snippets, an FQL syntax table, and manifest YAML blocks. Covers the common cases and includes error-path specifics (404 vs 429, result.errors messages); matches the anchor-5 example.

5 / 5

Workflow Clarity

Validation checkpoints exist — "Check the description against this table before running `collections create`", "Always check `result?.errors?.length` after write operations", "Verify persistence with a follow-up read or list call" — so the destructive/batch cap of 3 does not apply. However, there is no explicit end-to-end sequence (create → wire manifest → implement access → verify); the steps and checkpoints are scattered across reference sections rather than ordered, fitting anchor 4 rather than 5.

4 / 5

Progressive Disclosure

Section organization is good and the Reading Guide table clearly signals `references/advanced-patterns.md` (verified present, one level deep), but the body also points to `use-cases/collections.md` and `use-cases/lookup-table-enrichment.md` which do not exist in the bundle — broken navigation paths. Combined with substantial content inlined in SKILL.md (~390 lines including a full CRUD class that belongs in a reference), this sits between anchors 3 and 4, and the dead references are more than a minor gap.

3 / 5

Total

16

/

20

Passed

Description

95%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 model trigger description: concrete what-clause, comprehensive and natural trigger phrases including the exact CLI command, and an explicit negative boundary that routes adjacent work to sibling skills. Only weakness is that the capability list is slightly narrower than what the body actually covers.

DimensionReasoningScore

Specificity

"Design JSON Schema collections and CRUD patterns" plus trigger-side enumeration of "indexable fields, FQL queries, or collection access patterns" names several concrete actions in a well-defined domain, but the what-clause itself covers only two, leaving minor gaps (e.g., API/SDK object access, agent-tool exposure are absent). Fits anchor 4 rather than 5 because the capability list is not comprehensive, and above 3 because more than 1-2 specific actions are stated.

4 / 5

Completeness

Explicitly answers both questions: "what" in the opening sentence and "when" via "TRIGGER when user asks to ... or needs help with ..." with concrete trigger phrases, plus a negative boundary. Matches the anchor-5 example structure exactly; a missing or weak trigger clause would cap it at 3, which is not the case.

5 / 5

Trigger Term Quality

Covers natural user phrasings ("create a collection", "define a JSON schema", "store data in Foundry"), the exact CLI invocation `foundry collections create`, and domain terms (FQL queries, indexable fields), so keyword coverage is comprehensive with synonyms and the verbatim command. Not 4: no clearly missing natural term for this domain — the phrases map directly onto how a user would express the need.

5 / 5

Distinctiveness Conflict Risk

The niche is narrow (Falcon Foundry collections) and the "DO NOT TRIGGER for workflow YAML, function handlers, or UI components — use the appropriate sub-skill" clause explicitly disambiguates against the sibling skills most likely to collide. Minimal conflict risk; anchor 5 fits.

5 / 5

Total

19

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

13

/

16

Passed

Repository

CrowdStrike/foundry-skills

Path

skills/collections-development/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.