Skip to content

Sync CLI skills to the catalog + init revamp (catalog installs, workflow picker, drop build skills) - #203

Open
chenxin-yan wants to merge 6 commits into
firecrawl:mainfrom
chenxin-yan:catalog-sync
Open

Sync CLI skills to the catalog + init revamp (catalog installs, workflow picker, drop build skills)#203
chenxin-yan wants to merge 6 commits into
firecrawl:mainfrom
chenxin-yan:catalog-sync

Conversation

@chenxin-yan

Copy link
Copy Markdown
Contributor

Implements the cli-repo side of the skills-structure migration (phases 1 and 3).

CI: sync workflow

  • sync-catalog.yml: on push to skills/**, mirrors skills/ into firecrawl/skills under skills/cli/ — banner README, no-op detection, rebase-retry push, never force-push. Uses secret CATALOG_DEPLOY_KEY (already provisioned).

firecrawl init revamp

  • Installs CLI skills by default; workflow skills are an interactive multi-select (all pre-checked); build skills are no longer installed — they target SDK integration, not CLI users, and stay one command away in the catalog.
  • All installs now route through npx skills add firecrawl/skills --skill <names> (name-based, layout-independent), so init's install volume accrues to catalog counters from day one. The native no-npx installer gained the same name filter and fails loudly on missing names.
  • README: promotes npx skills add firecrawl/skills, adds the contributor routing rule.

Verification

  • tsc --noEmit clean, 415 tests pass (init tests updated to the new contract, including a regression check that no firecrawl-build* skill is installed), prettier clean.
  • Verified against skills CLI v1.5.23 source that add --skill accepts space-separated names.

Release gate

Merge after firecrawl/skills#14, dispatch sync-catalog.yml once, and only then publish to npm — the new init resolves skill names against the catalog, so skills/cli/ must be populated first.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 6 files

Prompt for AI agents (unresolved issues)

Check if these issues are valid — if so, understand the root cause of each and fix them. If appropriate, use sub-agents to investigate and fix each issue separately.


<file name="src/commands/init.ts">

<violation number="1" location="src/commands/init.ts:137">
P2: The retry hints in the new SkillSelection constants (lines 130/137) point at `firecrawl setup skills` and `firecrawl setup workflows`, but those setup subcommands still install from the old sources — `setup skills` uses SKILL_REPOS = firecrawl/cli + firecrawl/skills (which includes the build skills this PR removes from init) and `setup workflows` uses WORKFLOW_SKILL_REPOS = firecrawl/firecrawl-workflows rather than the catalog. So a retry after a failed `init` install installs a different skill set than init just tried (extra build skills / old workflow repo) and ignores the user's chosen subset. Align setup.ts's skills/workflows subcommands with the catalog name-based selection (or adjust the retry text) so the documented retry matches what init installs.</violation>
</file>

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread src/commands/init.ts
repo: CATALOG_REPO,
skills: WORKFLOW_SKILLS,
label: 'firecrawl workflow skills',
retryCommand: 'firecrawl setup workflows',

@cubic-dev-ai cubic-dev-ai Bot Aug 21, 2026

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2: The retry hints in the new SkillSelection constants (lines 130/137) point at firecrawl setup skills and firecrawl setup workflows, but those setup subcommands still install from the old sources — setup skills uses SKILL_REPOS = firecrawl/cli + firecrawl/skills (which includes the build skills this PR removes from init) and setup workflows uses WORKFLOW_SKILL_REPOS = firecrawl/firecrawl-workflows rather than the catalog. So a retry after a failed init install installs a different skill set than init just tried (extra build skills / old workflow repo) and ignores the user's chosen subset. Align setup.ts's skills/workflows subcommands with the catalog name-based selection (or adjust the retry text) so the documented retry matches what init installs.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At src/commands/init.ts, line 137:

<comment>The retry hints in the new SkillSelection constants (lines 130/137) point at `firecrawl setup skills` and `firecrawl setup workflows`, but those setup subcommands still install from the old sources — `setup skills` uses SKILL_REPOS = firecrawl/cli + firecrawl/skills (which includes the build skills this PR removes from init) and `setup workflows` uses WORKFLOW_SKILL_REPOS = firecrawl/firecrawl-workflows rather than the catalog. So a retry after a failed `init` install installs a different skill set than init just tried (extra build skills / old workflow repo) and ignores the user's chosen subset. Align setup.ts's skills/workflows subcommands with the catalog name-based selection (or adjust the retry text) so the documented retry matches what init installs.</comment>

<file context>
@@ -110,16 +110,32 @@ export const TEMPLATES: TemplateEntry[] = [
+  repo: CATALOG_REPO,
+  skills: WORKFLOW_SKILLS,
+  label: 'firecrawl workflow skills',
+  retryCommand: 'firecrawl setup workflows',
+};
 
</file context>
Fix with cubic

Mirror skills/ into catalog skills/cli/ on every push, with a mirror
banner README, no-op detection, and rebase-retry push via deploy key.
…p build skills

Route all init skill installs through the firecrawl/skills catalog with
name-based --skill selection so install volume accrues to catalog
counters. Interactive init now offers a multi-select of the 16 workflow
skills; build skills are no longer installed (they target SDK
integration, not CLI users, and remain one command away). Promote
npx skills add firecrawl/skills and the contributor routing rule in the
README.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 5 files (changes from recent commits).

Reply with feedback, questions, or to request a fix.

Fix all with cubic | Re-trigger cubic

Comment thread src/commands/setup.ts
The init retry hints point at setup skills/workflows, but those still
installed from the legacy repo list (including build skills init no
longer installs). Share the catalog selections between init and setup
so a retry reinstalls exactly what init attempted. Harden the sync
workflow: least-privilege token, SHA-pinned checkout.
They teach the firecrawl research and firecrawl developer CLI commands,
so this repo is their code home. Authored here, mirrored to the catalog
under skills/cli/, and included in the default init/setup CLI set.

@cubic-dev-ai cubic-dev-ai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 3 files (changes from recent commits).

Tip: Review your code locally with the cubic CLI to iterate faster.

Fix all with cubic | Re-trigger cubic

Comment thread skills/firecrawl-developer-index/SKILL.md Outdated
Comment thread skills/firecrawl-research-index/SKILL.md Outdated
Comment thread skills/firecrawl-research-index/SKILL.md Outdated
@chenxin-yan

Copy link
Copy Markdown
Contributor Author

Architecture update (pure catalog): the research/developer index skills now live here as CLI skills (they teach firecrawl research / firecrawl developer) and joined the default init/setup CLI set (12 skills). The catalog is fully read-only; routing rule updated.

Review fixes for firecrawl#203:
- setup's no-npx fallback called installSkillsNative(repo) without the
  name filter, installing the entire catalog (build skills included)
  instead of the selection every other install path uses
- drop the nonexistent --skills-only CLI flag from the developer-index
  skill (skills="only" stays HTTP/MCP-only per cli-argv contract)
- note that the workflow retry hint reinstalls all workflow skills, not
  the picked subset
- fix 'sturctural' typo in the research-index skill
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant