feat(skills): add registry doctor diagnostics and docs

src/config/schema.test.ts

@@ -664,3 +664,21 @@ describe('configSchema — agents truthfulness/autonomy', () => {
     })).toThrow();
   });
 });
+
+describe('configSchema — skills registry source', () => {
+  const minimalConfig = {
+    telegram: { bot_token: 'test', allowed_chat_ids: [1] },
+    models: { default: { provider: 'anthropic', model: 'claude-3' } },
+  };
+
+  it('accepts skills.registry_source when provided', () => {
+    const result = configSchema.parse({
+      ...minimalConfig,
+      skills: {
+        registry_source: 'https://registry.example/catalog.json',
+      },
+    });
+
+    expect(result.skills.registry_source).toBe('https://registry.example/catalog.json');
+  });
+});

src/config/schema.ts

@@ -134,6 +134,8 @@ const skillsShellRunnerGovernanceSchema = z.object({
 }).default({});
 
 const skillsSchema = z.object({
+  /** Registry catalog source for `flynn skills registry` and install-by-id (file path or HTTPS URL). */
+  registry_source: z.string().optional(),
   /** Directory for user-created workspace skills. */
   workspace_dir: z.string().optional(),
   /** Directory for managed (installed) skills. Defaults to ~/.flynn/workspace/skills. */