feat(cli): add --skills-only to the developer command

README.md

@@ -365,6 +365,7 @@ firecrawl developer "axum middleware ordering"
 | Option                | Description                               |
 | --------------------- | ----------------------------------------- |
 | `--limit <n>`         | Number of results (default: 20, max: 100) |
+| `--skills-only`       | Search only agent-skill files             |
 | `-o, --output <path>` | Save to file                              |
 | `--json`              | Output as compact JSON                    |
 | `--pretty`            | Pretty print JSON output                  |

src/__tests__/cli-argv.test.ts

@@ -30,6 +30,7 @@ describe('CLI argv parsing', () => {
     expect(result.status).toBe(0);
     expect(result.stdout).toContain('Usage: firecrawl developer');
     expect(result.stdout).toContain('--limit');
+    expect(result.stdout).toContain('--skills-only');
     expect(result.stderr).not.toContain('unknown command');
   });
 

src/__tests__/commands/developer.test.ts

@@ -67,6 +67,19 @@ describe('handleDeveloperSearchCommand', () => {
       );
     });
 
+    it('passes skills=only when skillsOnly is set', async () => {
+      mockHttpGet.mockResolvedValue(mockDeveloperResponse([sampleResult]));
+
+      await handleDeveloperSearchCommand({
+        query: 'tokio spawn_blocking',
+        skillsOnly: true,
+      });
+
+      expect(mockHttpGet).toHaveBeenCalledWith(
+        '/v2/developer/search?query=tokio+spawn_blocking&skills=only&integration=cli'
+      );
+    });
+
     it('passes k when a limit is provided', async () => {
       mockHttpGet.mockResolvedValue(mockDeveloperResponse([sampleResult]));
 

src/commands/developer.ts

@@ -69,6 +69,7 @@ export async function handleDeveloperSearchCommand(
     const params = new URLSearchParams();
     params.append('query', options.query);
     if (options.k != null) params.append('k', String(options.k));
+    if (options.skillsOnly) params.append('skills', 'only');
     const data = await getDeveloper<{ results?: DeveloperItem[] }>(
       `${BASE}?${params.toString()}`,
       options

src/index.ts

@@ -1063,6 +1063,7 @@ function createDeveloperCommand(): Command {
       parseInt
     )
     .addOption(new Option('--k <number>').argParser(parseInt).hideHelp())
+    .option('--skills-only', 'Search only agent-skill files', false)
     .option(
       '-k, --api-key <key>',
       'Firecrawl API key (overrides global --api-key)'
@@ -1083,6 +1084,7 @@ Examples:
       await handleDeveloperSearchCommand({
         query,
         k: researchLimit(options),
+        skillsOnly: options.skillsOnly,
         apiKey: options.apiKey,
         apiUrl: options.apiUrl,
         output: options.output,

src/types/developer.ts

@@ -1,6 +1,7 @@
 export interface DeveloperSearchOptions {
   query: string;
   k?: number;
+  skillsOnly?: boolean;
   apiKey?: string;
   apiUrl?: string;
   output?: string;