CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

72

Quality

91%

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

82%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 strong, high-density reference skill: executable code in three languages, platform-specific limits and failure modes Claude could not infer, and explicit validation guidance for writes and creation. Weaknesses are modest — redundant restatement in Common Pitfalls and dead `use-cases/` reference paths — and do not obscure navigation.

Suggestions

Deduplicate Common Pitfalls: the description-character rules, workflow share settings, CLI delete/read limitations, and indexable-field cap are each stated twice in full; keep one-line pointers to the earlier sections instead.

Fix or remove the Use Cases references — `use-cases/collections.md` and `use-cases/lookup-table-enrichment.md` do not exist in the bundle, so navigation from that section dead-ends.

Add a short numbered end-to-end walkthrough (name → description check → schema to /tmp → `collections create` → edit project copy → verify in manifest) to make the creation sequence explicit rather than implied by section order.

DimensionReasoningScore

Conciseness

The body is dense with non-obvious platform facts (naming rules, size limits, draft-7-only validation, silent-failure gotchas) and avoids explaining concepts Claude already knows. However, the Common Pitfalls section restates material already covered verbatim above it (description character rules, workflow share settings, CLI delete/read limits, indexable-field max), which is padding that could be trimmed. This sits between anchor 4 (efficient, minor over-explanation) and anchor 5 (every token earns its place), closer to 4.

4 / 5

Actionability

Fully executable guidance throughout: a copy-paste `foundry collections create` command, complete draft-7 JSON schemas, a full TypeScript CRUD class, working falconpy `CustomStorage` calls including a pagination loop, an FQL syntax table, and manifest YAML. This matches the top anchor (copy-paste ready code covering common cases), not anchor 4 which permits minor gaps.

5 / 5

Workflow Clarity

Validation checkpoints are explicit for risky operations — "Check the description against this table before running `collections create`", "check `result?.errors?.length` after write operations", "Verify persistence with a follow-up read or list call", and 404-vs-429/5xx error discrimination — so the destructive/batch cap does not apply. However, the end-to-end creation flow is scattered across sections (naming constraints → description rules → limits → schema → CLI scaffolding) rather than presented as one sequenced walkthrough, leaving it at anchor 4 (clear sequence, most checkpoints) rather than 5.

4 / 5

Progressive Disclosure

A Reading Guide table clearly signals the one-level-deep `references/advanced-patterns.md` (a real bundle file with its own load condition), and sections are well-organized with distinct headers. The gap: the Use Cases section points to `use-cases/collections.md` and `use-cases/lookup-table-enrichment.md`, which do not exist in the bundle, and the body leans on `../functions-development/references/python-patterns.md` from another skill. This is 'good structure, minor organization gaps' (anchor 4) rather than anchor 5's fully clean navigation.

4 / 5

Total

17

/

20

Passed

Description

100%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 is exemplary: concrete capabilities, natural trigger phrases including the exact CLI command, explicit when-to-use guidance, and a do-not-trigger boundary that disambiguates sibling sub-skills. It follows the third-person voice and contains no padding or over-claims.

DimensionReasoningScore

Specificity

"Design JSON Schema collections and CRUD patterns for Falcon Foundry apps" plus "indexable fields, FQL queries, or collection access patterns" lists multiple specific concrete actions covering the skill's full scope (schema design, CRUD, indexing, querying, access patterns). This matches the top anchor (comprehensive coverage of concrete actions) and exceeds anchor 4, which allows minor coverage gaps.

5 / 5

Completeness

It explicitly answers 'what' (design JSON Schema collections and CRUD patterns) and 'when' ("TRIGGER when user asks to..." with concrete trigger phrases and an exact command). This is the anchor-5 pattern (clear what AND when with concrete triggers); anchor 4 would require a weaker or less explicit 'when' clause.

5 / 5

Trigger Term Quality

Natural user phrases ("create a collection", "define a JSON schema", "store data in Foundry") are combined with the exact CLI invocation `foundry collections create` and technical synonyms (FQL queries, indexable fields). Coverage includes both what a user would say and what they would type, matching the comprehensive-synonyms anchor rather than anchor 4's 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The explicit negative boundary ("DO NOT TRIGGER for workflow YAML, function handlers, or UI components — use the appropriate sub-skill") carves out a clear niche and actively routes away from sibling skills. Distinct triggers plus a do-not-trigger list is minimal conflict risk, above anchor 4's 'minor overlap risk'.

5 / 5

Total

20

/

20

Passed

Validation

75%

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

Validation — 12 / 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

relative_links

Relative link issues: 1 suspicious

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

12

/

16

Passed

Repository
CrowdStrike/foundry-skills
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.