| name | review-skill-sflabs |
| title | Review Skill for SF Labs |
| summary | Pre-PR self-check that audits a local skill directory for Snowflake Labs catalog readiness. |
| description | Use when a contributor has built a Cortex Code skill locally and wants a pre-PR readiness check before opening a pull request against Snowflake-Labs/cortex-code-skills. Verdict: promote, adapt, or skip — with concrete fixes. Triggers: "review a skill", "is this skill ready for labs", "check this skill before PR", "audit skill for promotion", "does this skill belong in labs". |
| tools | ["Read","Edit","Glob","Grep","Bash","web_search","web_fetch"] |
| prompt | $review-skill-sflabs ~/.snowflake/cortex/skills/my-skill |
| language | en |
| status | Published |
| author | Daniel Myers, Cortex Code DevRel |
| type | snowflake |
| demo-url | |
Review Skill for SF Labs
When to Use
- A contributor has authored a skill locally and wants a pre-PR readiness check
- Before forking
Snowflake-Labs/cortex-code-skills to submit a new skill
- To get a checklist of mechanical fixes plus advisory findings before reviewers see the work
Overview
This skill inspects a local skill directory and produces an advisory report telling the contributor whether the skill is a fit for the public Labs catalog. It applies safe mechanical fixes in place (with the contributor's confirmation) and flags content rewrites that need human judgment. It does not fork, push, or open a PR — that is the contributor's call after seeing the report.
The review is advisory. Final acceptance is decided by reviewers on the pull request.
Inputs
The skill takes one argument: a path to a skill directory containing a SKILL.md.
$review-skill-sflabs <path>
If no argument is provided, the skill uses the current working directory. If the path does not contain a SKILL.md, stop with a clear error.
Workflow
Phase 1: Locate and load
- Resolve the input path. Validate that
<path>/SKILL.md exists.
- Read
SKILL.md plus all sibling files under <path>/references/, <path>/workflows/, and <path>/scripts/ into context. The Glob tool can enumerate them.
Phase 2: Run sub-workflows in order
Run each sub-workflow and accumulate findings.
- Format check — read
workflows/format-check.md and execute its steps. Output: list of (check_id, severity, evidence, fix, suggested_change) findings.
- Duplicate search — read
workflows/duplicate-search.md and execute. May reach a stopping point at "your work or adapted from <url>?" — wait for the contributor's selection before proceeding.
- Data policy scan — read
workflows/data-policy-scan.md and execute. Loads references/data-policy-principles.md first.
- Catalog fit — read
workflows/catalog-fit.md and execute. Includes both bundled-skill overlap (disk + docs) and scope flexibility reasoning.
If any later phase depends on data an earlier phase failed to gather, mark that phase as and continue.
