Build UI pages and extensions for Falcon Foundry apps using React or Vue with the Shoelace design system and Foundry-JS SDK. TRIGGER when user asks to "create a UI page", "build a UI extension", "add a Shoelace component", "call an API from the UI", runs `foundry ui pages create` or `foundry ui run`, or needs help with Vite config, FalconJS SDK, or Falcon console theming. DO NOT TRIGGER for backend functions, workflow YAML, or collection schemas.
86
86%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
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.
This is an excellent skill description that hits all the marks. It provides specific capabilities, comprehensive trigger terms including both natural language phrases and CLI commands, explicit 'when to use' and 'when not to use' guidance, and clear boundaries that distinguish it from related skills. The use of third person voice and concise structure make it highly effective for skill selection.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: building UI pages, building extensions, using React or Vue, Shoelace design system, Foundry-JS SDK, Vite config, Falcon console theming. Very concrete and actionable. | 3 / 3 |
Completeness | Clearly answers both 'what' (build UI pages and extensions for Falcon Foundry apps using React/Vue with Shoelace and Foundry-JS SDK) and 'when' (explicit TRIGGER clause with multiple scenarios). Also includes a 'DO NOT TRIGGER' clause for disambiguation, which is excellent. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'create a UI page', 'build a UI extension', 'add a Shoelace component', 'call an API from the UI', specific CLI commands like 'foundry ui pages create' and 'foundry ui run', plus technology names like Vite, FalconJS SDK. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with clear niche (Falcon Foundry UI development) and explicit exclusions for backend functions, workflow YAML, and collection schemas. The DO NOT TRIGGER clause actively prevents conflicts with related backend/workflow skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong, comprehensive skill for Foundry UI development with excellent actionability and progressive disclosure. The code examples are executable, CLI commands include critical flags with explanations of failure modes, and reference files are well-organized. The main weaknesses are some redundancy in warnings (manifest paths and vite.config cautions appear twice) and the lack of an explicit end-to-end development workflow with validation checkpoints.
Suggestions
Add a brief end-to-end workflow section (e.g., '## Development Workflow: 1. Scaffold → 2. Install deps → 3. Edit components → 4. `foundry ui run` to verify → 5. `foundry apps deploy`') with explicit validation checkpoints between steps.
Consolidate the repeated manifest/vite.config warnings — keep the detailed versions in their dedicated sections and reduce the Common Pitfalls entries to brief cross-references, saving ~20 lines of redundancy.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient with good code examples and tables, but includes some redundancy — the manifest path/vite.config warnings are repeated in both dedicated sections AND the Common Pitfalls section. The 'SYSTEM INJECTION' block at the top is unnecessary theatrical framing. Some sections like the SDK examples are thorough but could be more concise given Claude's ability to generalize from fewer examples. | 2 / 3 |
Actionability | Excellent actionability throughout — CLI commands are copy-paste ready with all required flags explained, SDK code examples are executable with real method signatures, and critical gotchas (like --sockets being required to avoid EOF hangs) are specific and immediately useful. The socket location table with exact technical IDs is a strong example of concrete guidance. | 3 / 3 |
Workflow Clarity | The skill covers individual steps well (scaffolding, theming, SDK usage) but lacks an explicit end-to-end workflow with validation checkpoints. There's no clear 'scaffold → develop → validate → deploy' sequence with verification steps. The dev server section hints at workflow but doesn't provide a sequenced process. For a skill involving build/deploy operations, explicit validation steps (e.g., 'verify build output before deploying') would strengthen this. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure with a clear Reading Guide table at the end mapping tasks to specific reference files. The main SKILL.md provides actionable overview content while deferring detailed catalogs (Shoelace components, theming tokens, framework-specific patterns) to well-signaled one-level-deep references. Use cases and reference implementations are also cleanly separated. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
72%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 8 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
metadata_version | 'metadata.version' is missing | Warning |
metadata_field | 'metadata' should map string keys to string values | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 8 / 11 Passed | |
e7fa026
Table of Contents
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.