agent-skills-standard 1.1.1 → 1.1.2

package/dist/commands/init.js

@@ -11,10 +11,12 @@ const node_fetch_1 = __importDefault(require("node-fetch"));
 const path_1 = __importDefault(require("path"));
 const picocolors_1 = __importDefault(require("picocolors"));
 const constants_1 = require("../constants");
+const github_1 = require("../utils/github");
+const project_1 = require("../utils/project");
 class InitCommand {
     async run() {
         const configPath = path_1.default.join(process.cwd(), '.skillsrc');
-        // Load package.json for dependency checks
+        // Load package.json for dependency checks (for framework detection)
         const packageJsonPath = path_1.default.join(process.cwd(), 'package.json');
         let packageDeps = {};
         if (await fs_extra_1.default.pathExists(packageJsonPath)) {
@@ -64,33 +66,30 @@ class InitCommand {
         // Default to a sane list if registry is unreachable
         let supportedCategories = ['flutter', 'dart'];
         let metadata = {};
-        const treeUrl = 'https://api.github.com/repos/HoangNguyen0403/agent-skills-standard/git/trees/main?recursive=1';
-        const metadataUrl = 'https://raw.githubusercontent.com/HoangNguyen0403/agent-skills-standard/main/skills/metadata.json';
+        // Attempt to discover available categories and registry metadata from the canonical registry
         try {
-            const [treeRes, metadataRes] = await Promise.all([
-                (0, node_fetch_1.default)(treeUrl, {
-                    headers: { Accept: 'application/vnd.github.v3+json' },
-                }),
-                (0, node_fetch_1.default)(metadataUrl),
-            ]);
-            if (metadataRes.ok) {
-                metadata = (await metadataRes.json());
-            }
-            if (treeRes.ok) {
-                const treeData = (await treeRes.json());
-                const allFiles = treeData.tree || [];
-                // Extract top-level folders in skills/
-                const categories = new Set();
-                allFiles.forEach((f) => {
-                    if (f.path.startsWith('skills/') && f.type === 'tree') {
-                        const parts = f.path.split('/');
-                        if (parts.length === 2) {
-                            categories.add(parts[1]);
+            const defaultRegistry = 'https://github.com/HoangNguyen0403/agent-skills-standard';
+            const parsed = (0, github_1.parseRegistryUrl)(defaultRegistry);
+            if (parsed) {
+                const treeResult = await (0, github_1.fetchRepoTree)(parsed.owner, parsed.repo);
+                if (treeResult && Array.isArray(treeResult.data.tree)) {
+                    const allFiles = treeResult.data.tree || [];
+                    const categories = new Set();
+                    allFiles.forEach((f) => {
+                        if (f.path.startsWith('skills/') && f.type === 'tree') {
+                            const parts = f.path.split('/');
+                            if (parts.length === 2)
+                                categories.add(parts[1]);
                         }
+                    });
+                    if (categories.size > 0)
+                        supportedCategories = Array.from(categories);
+                    // Try to fetch metadata.json at the resolved branch
+                    const metaUrl = `https://raw.githubusercontent.com/${parsed.owner}/${parsed.repo}/${treeResult.branch}/skills/metadata.json`;
+                    const metaRes = await (0, node_fetch_1.default)(metaUrl);
+                    if (metaRes.ok) {
+                        metadata = (await metaRes.json());
                     }
-                });
-                if (categories.size > 0) {
-                    supportedCategories = Array.from(categories);
                 }
             }
         }
@@ -161,6 +160,9 @@ class InitCommand {
         if (framework === constants_1.Framework.NextJS || framework === constants_1.Framework.ReactNative) {
             neededSkills.add(constants_1.Framework.React);
         }
+        // Add framework-specific skills from the registry to potential skills
+        const frameworkSkills = constants_1.SKILL_DETECTION_REGISTRY[framework] || [];
+        frameworkSkills.forEach((s) => neededSkills.add(s.id));
         const config = {
             registry: answers.registry,
             agents: answers.agents,
@@ -172,6 +174,7 @@ class InitCommand {
         const allKnownCategories = [
             ...constants_1.SUPPORTED_FRAMEWORKS.map((f) => f.id),
             ...constants_1.SUPPORTED_FRAMEWORKS.flatMap((f) => f.languages),
+            ...Object.values(constants_1.SKILL_DETECTION_REGISTRY).flatMap((skills) => skills.map((s) => s.id)),
         ];
         for (const skill of [...new Set(allKnownCategories)]) {
             if (neededSkills.has(skill)) {
@@ -186,7 +189,34 @@ class InitCommand {
                 };
             }
         }
-        await fs_extra_1.default.writeFile(configPath, js_yaml_1.default.dump(config));
+        // Detect common framework skills and disable them if not used
+        const projectDeps = await (0, project_1.buildProjectDeps)();
+        for (const skill of frameworkSkills) {
+            const entry = config.skills[skill.id];
+            if (!entry)
+                continue;
+            // Only rely on declared dependencies for detection.
+            const used = skill.packages.some((p) => projectDeps.has(p));
+            // If not used, add to parent framework's exclude list so users
+            // see which sub-skills were disabled by detection and can opt-in.
+            if (!used) {
+                const parent = config.skills[framework] || { enabled: true };
+                const excludes = parent.exclude ? [...parent.exclude] : [];
+                if (!excludes.includes(skill.id))
+                    excludes.push(skill.id);
+                parent.exclude = excludes;
+                config.skills[framework] = parent;
+            }
+        }
+        const commentHeader = `# Auto-detected configuration generated by agent-skills-standard init
+#
+# 'exclude': IDs of sub-skills to skip during sync (auto-populated with undetected skills).
+# 'custom_overrides': IDs of skills to PROTECT. Use this if you have modified a standard 
+# skill locally and don't want the CLI to overwrite it.
+#
+# Run 'ags list-skills' to view all available skills.
+`;
+        await fs_extra_1.default.writeFile(configPath, commentHeader + js_yaml_1.default.dump(config));
         console.log(picocolors_1.default.green('\n✅ Initialized .skillsrc with your preferences!'));
         console.log(picocolors_1.default.gray(`   Selected framework: ${framework}`));
         console.log(picocolors_1.default.gray(`   Auto-enabled languages: ${Array.from(neededSkills)

package/dist/commands/list-skills.d.ts

@@ -0,0 +1,3 @@
+export declare class ListSkillsCommand {
+    run(): Promise<void>;
+}

package/dist/commands/list-skills.js

@@ -0,0 +1,81 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListSkillsCommand = void 0;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const path_1 = __importDefault(require("path"));
+const picocolors_1 = __importDefault(require("picocolors"));
+const constants_1 = require("../constants");
+const github_1 = require("../utils/github");
+const project_1 = require("../utils/project");
+class ListSkillsCommand {
+    async run() {
+        const choices = constants_1.SUPPORTED_FRAMEWORKS.map((f) => ({
+            name: f.name,
+            value: f.id,
+        }));
+        const { framework } = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'framework',
+                message: 'Select framework to list available skills for:',
+                choices,
+                default: choices.find((c) => c.value === constants_1.Framework.Flutter)?.value,
+            },
+        ]);
+        const projectDeps = await (0, project_1.buildProjectDeps)();
+        console.log(picocolors_1.default.green(`\nAvailable skills for ${framework}:`));
+        // Determine registry URL (from .skillsrc or default)
+        const defaultRegistry = 'https://github.com/HoangNguyen0403/agent-skills-standard';
+        let registryUrl = defaultRegistry;
+        const configPath = path_1.default.join(process.cwd(), '.skillsrc');
+        if (await fs_extra_1.default.pathExists(configPath)) {
+            const raw = await fs_extra_1.default.readFile(configPath, 'utf8');
+            const conf = js_yaml_1.default.load(raw);
+            if (conf && conf.registry)
+                registryUrl = conf.registry;
+        }
+        // Try to fetch the repo tree to list all skills under skills/<framework>/
+        let skillFolders = [];
+        try {
+            const parsed = (0, github_1.parseRegistryUrl)(registryUrl);
+            if (parsed) {
+                const treeResult = await (0, github_1.fetchRepoTree)(parsed.owner, parsed.repo);
+                if (treeResult && Array.isArray(treeResult.data.tree)) {
+                    const allFiles = treeResult.data.tree || [];
+                    skillFolders = Array.from(new Set(allFiles
+                        .filter((f) => f.path.startsWith(`skills/${framework}/`))
+                        .map((f) => {
+                        const parts = f.path.split('/');
+                        return parts[2];
+                    })
+                        .filter(Boolean)));
+                }
+            }
+        }
+        catch {
+            // ignore network errors and fall back to detection registry
+        }
+        // Fallback: use detection registry skill ids if we couldn't fetch tree
+        const detectSkills = constants_1.SKILL_DETECTION_REGISTRY[framework] || [];
+        if (!skillFolders || skillFolders.length === 0) {
+            skillFolders = detectSkills.map((s) => s.id);
+        }
+        // For each discovered skill, show whether it would be detected (if we have rules)
+        for (const skillName of skillFolders.sort()) {
+            const detectRule = detectSkills.find((x) => x.id === skillName);
+            let mark = picocolors_1.default.yellow('no-rule');
+            if (detectRule) {
+                const present = detectRule.packages.some((p) => projectDeps.has(p));
+                mark = present ? picocolors_1.default.green('detected') : picocolors_1.default.gray('not-detected');
+            }
+            console.log(`- ${skillName} (${mark})`);
+        }
+        console.log('\nTip: Use the .skillsrc exclude array to disable/enable sub-skills before running sync.');
+    }
+}
+exports.ListSkillsCommand = ListSkillsCommand;

package/dist/constants/index.d.ts

@@ -35,3 +35,4 @@ export declare const getAgentDefinition: (id: Agent) => AgentDefinition;
 export declare const getFrameworkDefinition: (id: Framework) => FrameworkDefinition;
 export declare const SUPPORTED_AGENTS: AgentDefinition[];
 export declare const SUPPORTED_FRAMEWORKS: FrameworkDefinition[];
+export { SKILL_DETECTION_REGISTRY, SkillDetection } from './skills';

package/dist/constants/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SUPPORTED_FRAMEWORKS = exports.SUPPORTED_AGENTS = exports.getFrameworkDefinition = exports.getAgentDefinition = exports.Framework = exports.Agent = void 0;
+exports.SKILL_DETECTION_REGISTRY = exports.SUPPORTED_FRAMEWORKS = exports.SUPPORTED_AGENTS = exports.getFrameworkDefinition = exports.getAgentDefinition = exports.Framework = exports.Agent = void 0;
 var Agent;
 (function (Agent) {
     Agent["Cursor"] = "cursor";
@@ -151,3 +151,5 @@ const getFrameworkDefinition = (id) => {
 exports.getFrameworkDefinition = getFrameworkDefinition;
 exports.SUPPORTED_AGENTS = Object.values(Agent).map(exports.getAgentDefinition);
 exports.SUPPORTED_FRAMEWORKS = Object.values(Framework).map(exports.getFrameworkDefinition);
+var skills_1 = require("./skills");
+Object.defineProperty(exports, "SKILL_DETECTION_REGISTRY", { enumerable: true, get: function () { return skills_1.SKILL_DETECTION_REGISTRY; } });

package/dist/constants/skills.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SkillDetection defines how to automatically enable a skill based on project dependencies.
+ */
+export interface SkillDetection {
+    /** The skill ID as defined in the registry (e.g., 'riverpod-state-management') */
+    id: string;
+    /** List of npm or pub packages that indicate this skill is used */
+    packages: string[];
+}
+/**
+ * Registry of automatic skill detection rules grouped by framework.
+ */
+export declare const SKILL_DETECTION_REGISTRY: Record<string, SkillDetection[]>;

package/dist/constants/skills.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_DETECTION_REGISTRY = void 0;
+const index_1 = require("./index");
+/**
+ * Registry of automatic skill detection rules grouped by framework.
+ */
+exports.SKILL_DETECTION_REGISTRY = {
+    [index_1.Framework.Flutter]: [
+        {
+            id: 'riverpod-state-management',
+            packages: ['flutter_riverpod', 'riverpod'],
+        },
+        {
+            id: 'bloc-state-management',
+            packages: ['flutter_bloc', 'bloc'],
+        },
+        {
+            id: 'auto-route-navigation',
+            packages: ['auto_route'],
+        },
+        {
+            id: 'go-router-navigation',
+            packages: ['go_router'],
+        },
+        {
+            id: 'getx-navigation',
+            packages: ['get'],
+        },
+        {
+            id: 'getx-state-management',
+            packages: ['get'],
+        },
+        {
+            id: 'localization',
+            packages: ['easy_localization'],
+        },
+        {
+            id: 'retrofit-networking',
+            packages: ['retrofit'],
+        },
+    ],
+    [index_1.Framework.NestJS]: [
+        {
+            id: 'caching',
+            packages: ['@nestjs/cache-manager', 'cache-manager'],
+        },
+        {
+            id: 'database',
+            packages: ['@nestjs/typeorm', '@nestjs/prisma', '@nestjs/mongoose'],
+        },
+        {
+            id: 'security',
+            packages: ['@nestjs/passport', 'passport', 'helmet'],
+        },
+    ],
+};

package/dist/index.js

@@ -3,12 +3,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
 const init_1 = require("./commands/init");
+const list_skills_1 = require("./commands/list-skills");
 const sync_1 = require("./commands/sync");
 const program = new commander_1.Command();
 program
     .name('agent-skills-standard')
     .description('A CLI to manage and sync AI agent skills for Cursor, Claude, Copilot, and more.')
-    .version('1.1.1');
+    .version('1.1.2');
 program
     .command('init')
     .description('Initialize a .skillsrc configuration file interactively')
@@ -23,4 +24,11 @@ program
     const sync = new sync_1.SyncCommand();
     await sync.run();
 });
+program
+    .command('list-skills')
+    .description('List available framework skills and detection status')
+    .action(async () => {
+    const cmd = new list_skills_1.ListSkillsCommand();
+    await cmd.run();
+});
 program.parse();

package/dist/utils/github.d.ts

@@ -0,0 +1,10 @@
+import { GitHubTreeResponse } from '../models/types';
+export declare function parseRegistryUrl(registryUrl: string): {
+    owner: string;
+    repo: string;
+} | null;
+export declare function fetchRepoTree(owner: string, repo: string, ref?: string): Promise<{
+    data: GitHubTreeResponse;
+    branch: string;
+} | null>;
+export default fetchRepoTree;

package/dist/utils/github.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRegistryUrl = parseRegistryUrl;
+exports.fetchRepoTree = fetchRepoTree;
+const node_fetch_1 = __importDefault(require("node-fetch"));
+function parseRegistryUrl(registryUrl) {
+    const m = registryUrl.match(/github\.com\/([^/]+)\/([^/]+)/i);
+    if (!m)
+        return null;
+    return { owner: m[1], repo: m[2].replace(/\.git$/, '') };
+}
+async function fetchRepoTree(owner, repo, ref) {
+    try {
+        let branch = ref;
+        if (!branch) {
+            // Resolve default branch
+            const repoRes = await (0, node_fetch_1.default)(`https://api.github.com/repos/${owner}/${repo}`);
+            if (!repoRes.ok)
+                return null;
+            const repoData = (await repoRes.json());
+            branch = repoData.default_branch || 'main';
+        }
+        const treeUrl = `https://api.github.com/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
+        const res = await (0, node_fetch_1.default)(treeUrl, {
+            headers: { Accept: 'application/vnd.github.v3+json' },
+        });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return { data, branch };
+    }
+    catch {
+        return null;
+    }
+}
+exports.default = fetchRepoTree;

package/dist/utils/project.d.ts

@@ -0,0 +1,2 @@
+export declare function buildProjectDeps(): Promise<Set<string>>;
+export default buildProjectDeps;

package/dist/utils/project.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProjectDeps = buildProjectDeps;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+async function buildProjectDeps() {
+    const set = new Set();
+    const packageJsonPath = path_1.default.join(process.cwd(), 'package.json');
+    if (await fs_extra_1.default.pathExists(packageJsonPath)) {
+        try {
+            const pkg = await fs_extra_1.default.readJson(packageJsonPath);
+            const deps = {
+                ...(pkg.dependencies || {}),
+                ...(pkg.devDependencies || {}),
+            };
+            for (const k of Object.keys(deps))
+                set.add(k);
+        }
+        catch {
+            // ignore
+        }
+    }
+    const pubspecPath = path_1.default.join(process.cwd(), 'pubspec.yaml');
+    if (await fs_extra_1.default.pathExists(pubspecPath)) {
+        try {
+            const loaded = await fs_extra_1.default.readFile(pubspecPath, 'utf8');
+            // simple parse: only collect keys inside dependencies/dev_dependencies sections
+            const lines = loaded.split(/\r?\n/);
+            let currentSection = null;
+            let sectionIndent = null;
+            for (const line of lines) {
+                const sectionMatch = line.match(/^(\s*)(dependencies|dev_dependencies)\s*:/);
+                if (sectionMatch) {
+                    currentSection = sectionMatch[2];
+                    sectionIndent = sectionMatch[1].length;
+                    continue;
+                }
+                if (!currentSection || sectionIndent === null)
+                    continue;
+                const entryMatch = line.match(/^(\s*)([a-zA-Z0-9_\-@\\/]+)\s*:/);
+                if (!entryMatch)
+                    continue;
+                const indent = entryMatch[1].length;
+                const key = entryMatch[2];
+                // only include keys that are nested under the current section and are not known non-packages
+                if (indent > sectionIndent && key !== 'sdk' && key !== 'flutter') {
+                    set.add(key);
+                }
+            }
+        }
+        catch {
+            // ignore
+        }
+    }
+    return set;
+}
+exports.default = buildProjectDeps;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-skills-standard",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "A CLI to manage and sync AI agent skills standard for Cursor, Claude, Copilot, and more.",
   "main": "dist/index.js",
   "bin": {
@@ -24,7 +24,7 @@
   "dependencies": {
     "commander": "^11.1.0",
     "fs-extra": "^11.2.0",
-    "inquirer": "^9.2.12",
+    "inquirer": "^8.2.5",
     "js-yaml": "^4.1.0",
     "node-fetch": "^2.7.0",
     "picocolors": "^1.0.0"
@@ -32,7 +32,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@types/fs-extra": "^11.0.4",
-    "@types/inquirer": "^9.0.7",
+    "@types/inquirer": "^8.2.5",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.5",
     "@types/node-fetch": "^2.6.9",