@almyty/skills 1.0.0 → 1.0.2

package/README.md

@@ -0,0 +1,70 @@
+# @almyty/skills
+
+Install and manage AI skills from [almyty](https://almyty.com) in 30+ coding agents.
+
+## Quick Start
+
+```bash
+# Install skills from a gateway
+npx @almyty/skills install @your-org/your-gateway
+
+# Keep skills synced (daemon mode)
+npx @almyty/skills daemon
+
+# Run a skill directly
+npx @almyty/skills run @your-org/your-gateway/tool-name --param value
+```
+
+## What It Does
+
+almyty turns any API into AI-ready tools. This CLI installs those tools as **SKILL.md files** into your project, where they're automatically picked up by supported agents.
+
+## Supported Agents
+
+| Category | Agents |
+|----------|--------|
+| **IDE** | Claude Code, Cursor, Windsurf, VS Code Copilot, JetBrains |
+| **AI Assistants** | Claude Desktop, ChatGPT, Gemini |
+| **Dev Tools** | Aider, Continue, Cody, GitHub Copilot CLI |
+| **Frameworks** | LangChain, LlamaIndex, CrewAI, AutoGPT |
+
+## Commands
+
+```
+npx @almyty/skills login              Authenticate with almyty
+npx @almyty/skills logout             Remove stored credentials
+npx @almyty/skills daemon             Start skill daemon (syncs all skills)
+npx @almyty/skills install <ref>      Install skills from a gateway
+npx @almyty/skills list [ref]         List available skills
+npx @almyty/skills search <query>     Search for skills
+npx @almyty/skills run <ref>          Execute a skill
+npx @almyty/skills installed          Show locally installed skills
+npx @almyty/skills remove             Remove all installed skills
+npx @almyty/skills gateways           List your gateways
+```
+
+## References
+
+Skills are referenced as `@org/gateway` or `@org/gateway/skill`:
+
+```bash
+npx @almyty/skills install @acme/petstore        # All skills from a gateway
+npx @almyty/skills run @acme/petstore/get-pet     # Run a specific skill
+```
+
+## Configuration
+
+Create `.almytyrc` in your project or home directory:
+
+```json
+{
+  "url": "https://api.almyty.com",
+  "token": "your-token"
+}
+```
+
+Or use environment variables: `ALMYTY_URL`, `ALMYTY_TOKEN`.
+
+## License
+
+BSL-1.1

package/dist/auth.d.ts

@@ -4,7 +4,7 @@
  * Shares credentials with @almyty/mcp-server via ~/.almyty/credentials.json.
  *
  * Supports:
- * 1. Environment variable (APIFAI_TOKEN) — for CI/scripts
+ * 1. Environment variable (ALMYTY_TOKEN) — for CI/scripts
  * 2. Stored credentials (~/.almyty/credentials.json) — for interactive use
  * 3. Interactive login (npx @almyty/skills login) — stores credentials
  */

package/dist/auth.js

@@ -4,7 +4,7 @@
  * Shares credentials with @almyty/mcp-server via ~/.almyty/credentials.json.
  *
  * Supports:
- * 1. Environment variable (APIFAI_TOKEN) — for CI/scripts
+ * 1. Environment variable (ALMYTY_TOKEN) — for CI/scripts
  * 2. Stored credentials (~/.almyty/credentials.json) — for interactive use
  * 3. Interactive login (npx @almyty/skills login) — stores credentials
  */
@@ -56,8 +56,8 @@ export function logout() {
  * Resolve token: env var > stored credentials
  */
 export function resolveAuth() {
-    const envToken = process.env.APIFAI_TOKEN;
-    const envUrl = process.env.APIFAI_URL || 'https://api.almyty.com';
+    const envToken = process.env.ALMYTY_TOKEN;
+    const envUrl = process.env.ALMYTY_URL || 'https://api.almyty.com';
     if (envToken) {
         return { url: envUrl, token: envToken };
     }
@@ -67,7 +67,7 @@ export function resolveAuth() {
     }
     console.error('Not authenticated. Run one of:');
     console.error('  npx @almyty/skills login');
-    console.error('  export APIFAI_TOKEN=<your-token>');
+    console.error('  export ALMYTY_TOKEN=<your-token>');
     process.exit(1);
 }
 /**

package/dist/config.js

@@ -3,7 +3,7 @@ import { homedir } from 'os';
 import { join, resolve } from 'path';
 import { detectAgents, getDefaultTargets, filterAgents } from './agents.js';
 export function loadConfig(projectDir) {
-    const envDir = process.env.APIFAI_SKILLS_DIR;
+    const envDir = process.env.ALMYTY_SKILLS_DIR;
     if (envDir) {
         return { skillsDir: envDir };
     }

package/dist/index.js

@@ -33,9 +33,9 @@ References:
 
 Config:
   .almytyrc                      JSON config file (project or home dir)
-  APIFAI_SKILLS_DIR              Override skill installation directory
-  APIFAI_URL                     Override API URL
-  APIFAI_TOKEN                   Override auth token
+  ALMYTY_SKILLS_DIR              Override skill installation directory
+  ALMYTY_URL                     Override API URL
+  ALMYTY_TOKEN                   Override auth token
 
 Options:
   --interval, -i <seconds>       Daemon poll interval in seconds (default: 60)
@@ -143,7 +143,7 @@ async function main() {
     const urlOverride = args.flags.url || config.url;
     switch (command) {
         case 'login': {
-            const url = urlOverride || process.env.APIFAI_URL || 'https://api.almyty.com';
+            const url = urlOverride || process.env.ALMYTY_URL || 'https://api.almyty.com';
             await login(url);
             break;
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almyty/skills",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Install API skills into AI coding agents — Claude Code, Cursor, Windsurf, Copilot, Codex",
   "type": "module",
   "main": "dist/index.js",

package/dist/__tests__/client.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/__tests__/client.test.js

@@ -1,145 +0,0 @@
-import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
-import { parseRef } from '../client.js';
-import { generateMetaSkill } from '../meta-skill.js';
-import { loadConfig } from '../config.js';
-// ---------------------------------------------------------------------------
-// parseRef()
-// ---------------------------------------------------------------------------
-describe('parseRef', () => {
-    it('parses @org/gateway as a gateway ref', () => {
-        const result = parseRef('@org/gateway');
-        expect(result).toEqual({
-            type: 'gateway',
-            orgSlug: 'org',
-            gatewaySlug: 'gateway',
-            raw: '@org/gateway',
-        });
-    });
-    it('parses @org/gateway/skill as a skill ref', () => {
-        const result = parseRef('@org/gateway/skill');
-        expect(result).toEqual({
-            type: 'skill',
-            orgSlug: 'org',
-            gatewaySlug: 'gateway',
-            skillName: 'skill',
-            raw: '@org/gateway/skill',
-        });
-    });
-    it('parses a UUID string as a uuid ref', () => {
-        const uuid = 'a1b2c3d4-e5f6-7890-abcd-ef1234567890';
-        const result = parseRef(uuid);
-        expect(result).toEqual({
-            type: 'uuid',
-            uuid,
-            raw: uuid,
-        });
-    });
-    it('parses uppercase UUID correctly', () => {
-        const uuid = 'A1B2C3D4-E5F6-7890-ABCD-EF1234567890';
-        const result = parseRef(uuid);
-        expect(result.type).toBe('uuid');
-        expect(result.uuid).toBe(uuid);
-    });
-    it('returns search for a random string', () => {
-        const result = parseRef('some-random-query');
-        expect(result).toEqual({
-            type: 'search',
-            raw: 'some-random-query',
-        });
-    });
-    it('returns search for an empty string', () => {
-        const result = parseRef('');
-        expect(result).toEqual({
-            type: 'search',
-            raw: '',
-        });
-    });
-    it('returns search for @ with only one segment', () => {
-        const result = parseRef('@org');
-        expect(result).toEqual({
-            type: 'search',
-            raw: '@org',
-        });
-    });
-    it('returns search for @ with more than three segments', () => {
-        const result = parseRef('@org/gw/skill/extra');
-        expect(result).toEqual({
-            type: 'search',
-            raw: '@org/gw/skill/extra',
-        });
-    });
-});
-// ---------------------------------------------------------------------------
-// generateMetaSkill()
-// ---------------------------------------------------------------------------
-describe('generateMetaSkill', () => {
-    it('returns a SkillFile with name "skills" and fileName "almyty-skills"', () => {
-        const skill = generateMetaSkill();
-        expect(skill.name).toBe('skills');
-        expect(skill.fileName).toBe('almyty-skills');
-    });
-    it('content includes npx @almyty/skills commands', () => {
-        const { content } = generateMetaSkill();
-        expect(content).toContain('npx @almyty/skills');
-    });
-    it('content references daemon command', () => {
-        const { content } = generateMetaSkill();
-        expect(content).toContain('daemon');
-    });
-    it('content references search command', () => {
-        const { content } = generateMetaSkill();
-        expect(content).toContain('search');
-    });
-    it('content references install command', () => {
-        const { content } = generateMetaSkill();
-        expect(content).toContain('install');
-    });
-    it('content references run command', () => {
-        const { content } = generateMetaSkill();
-        expect(content).toContain('run');
-    });
-    it('content includes SKILL.md front-matter', () => {
-        const { content } = generateMetaSkill();
-        expect(content).toContain('---');
-        expect(content).toContain('name: almyty-skills');
-        expect(content).toContain('description:');
-    });
-});
-// ---------------------------------------------------------------------------
-// loadConfig()
-// ---------------------------------------------------------------------------
-describe('loadConfig', () => {
-    const originalEnv = process.env;
-    beforeEach(() => {
-        // Reset env between tests
-        process.env = { ...originalEnv };
-        delete process.env.APIFAI_SKILLS_DIR;
-    });
-    afterEach(() => {
-        process.env = originalEnv;
-        vi.restoreAllMocks();
-    });
-    it('returns empty config when no .almytyrc exists and no env var', () => {
-        // Use a temp directory that definitely has no .almytyrc
-        const config = loadConfig('/tmp/nonexistent-dir-' + Date.now());
-        expect(config).toEqual({});
-    });
-    it('uses APIFAI_SKILLS_DIR env var when set', () => {
-        process.env.APIFAI_SKILLS_DIR = '/custom/skills/dir';
-        const config = loadConfig();
-        expect(config).toEqual({ skillsDir: '/custom/skills/dir' });
-    });
-    it('env var takes precedence over .almytyrc files', () => {
-        process.env.APIFAI_SKILLS_DIR = '/env/override';
-        // Even if we pass a projectDir, env should take priority
-        const config = loadConfig('/some/project');
-        expect(config.skillsDir).toBe('/env/override');
-    });
-    it('returns empty config for a directory with no rc file and no home rc', () => {
-        // Use a deeply nested temp path that certainly has no .almytyrc anywhere
-        // and also won't match ~/.almytyrc (already handled by the missing file)
-        const fakePath = `/tmp/almyty-test-${Date.now()}/deeply/nested/project`;
-        const config = loadConfig(fakePath);
-        expect(config).toEqual({});
-    });
-});