@appxiom/mcp-skills 1.0.0 → 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 1.0.1
+
+- Fixed the `telemetry` alias so `add telemetry` installs `occurrence-telemetry-analysis`.
+- Added package metadata (author, homepage, engines).
+- Added support for `--agent claude|copilot` with `.agent/skills` as the default target.
+
+## 1.0.0
+
+- Initial release with four MCP skills.

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright (c) 2026 BasilGregory Software Labs Private Limited
+
+All rights reserved.
+
+This software is licensed, not sold. No part of this software may be copied, modified, distributed, reverse engineered, or used except as expressly permitted by BasilGregory Software Labs Private Limited.

package/README.md

@@ -1,27 +1,48 @@
-# Appxiom MCP Skills (`@appxiom/mcp-skills`)
+# Appxiom MCP Skills
 
-A collection of AI Agent Skills and runbooks for Appxiom MCP Server integrations.
+Installable skills for working with the Appxiom MCP Server (issues, goals, quality scores and occurrence telemetry), plus a CLI to install them into whichever coding agent's skills directory your project uses.
 
-## Included Skills
+## Available Skills
 
-- **`goal-friction-analysis`**: Multi-factor ranking of goal conversion drop-offs, device impacts, and funnel health.
-- **`issue-severity-classification`**: Standardized protocol to classify issue severity based on business impact and error rates.
-- **`quality-score-interpretation`**: Guidance for evaluating Appxiom dashboard quality metrics and score trends.
-- **`occurrence-telemetry-analysis`**:  Root cause analysis across activity trails, function parameters, network parameters, device hardware, and runtime state data.
+| Skill | Folder | Covers |
+| --- | --- | --- |
+| `goals` | [goal-friction-analysis](./goal-friction-analysis/SKILL.md) | Multi-factor ranking of goal conversion drop-offs, device impacts and funnel health |
+| `severity` | [issue-severity-classification](./issue-severity-classification/SKILL.md) | Standardized protocol to classify issue severity (fatal, major, minor) based on business impact and error rates |
+| `quality` | [quality-score-interpretation](./quality-score-interpretation/SKILL.md) | Evaluating Appxiom Quality Score metrics, release stability and score trends |
+| `telemetry` | [occurrence-telemetry-analysis](./occurrence-telemetry-analysis/SKILL.md) | Root cause analysis across activity trails, function parameters, network parameters, device hardware and runtime state data |
 
-## Installation & Usage
-
-### 1. Install All Skills via NPX (Recommended)
-Copy all skills into your project's `.agents/skills/` directory:
+## Install via npx
 
 ```bash
-npx @appxiom/mcp-skills add all
-```
-
-### 2. Add Individual Skills
-```bash
+# Install goal friction analysis skill
 npx @appxiom/mcp-skills add goals
+ 
+# Install issue severity classification skill
 npx @appxiom/mcp-skills add severity
+ 
+# Install quality score interpretation skill
 npx @appxiom/mcp-skills add quality
+ 
+# Install occurrence telemetry analysis skill
 npx @appxiom/mcp-skills add telemetry
+ 
+# Install all skills
+npx @appxiom/mcp-skills add all
 ```
+
+This copies the requested `SKILL.md` (and any supporting files) into your project's coding-agent skills directory.
+
+### Target Directory Detection
+
+By default, the CLI auto-detects which directory to install into based on markers in your project:
+
+- `.claude/` exists → installs to `.claude/skills/<skill-name>/`
+- Otherwise → installs to `.agent/skills/<skill-name>/` (the default)
+
+Override auto-detection when needed:
+
+```bash
+npx @appxiom/mcp-skills add all --agent claude
+npx @appxiom/mcp-skills add all --agent copilot
+npx @appxiom/mcp-skills add all --target ./custom/skills/dir
+```

package/bin/cli.js

@@ -8,6 +8,7 @@ const SKILLS = {
   goals: 'goal-friction-analysis',
   severity: 'issue-severity-classification',
   quality: 'quality-score-interpretation',
+  telemetry: 'occurrence-telemetry-analysis',
   'goal-friction-analysis': 'goal-friction-analysis',
   'issue-severity-classification': 'issue-severity-classification',
   'quality-score-interpretation': 'quality-score-interpretation',
@@ -24,10 +25,9 @@ const ALL_SKILLS = [
 const AGENT_TARGET_DIRS = {
   claude: '.claude/skills',
   copilot: '.agent/skills',
-  agents: '.agents/skills',
 };
 
-const DEFAULT_AGENT = 'agents';
+const DEFAULT_AGENT = 'copilot';
 
 function printUsage() {
   console.log(`
@@ -42,7 +42,7 @@ Skills:
 
 Options:
   --target <dir>     Explicit directory to install skill(s) into
-  --agent <name>     Coding agent to target: "claude", "copilot", or "agents"
+  --agent <name>     Coding agent to target: "claude" or "copilot"
                      (auto-detected from the project if omitted)
 
 Examples:
@@ -58,9 +58,7 @@ function detectAgentTargetDir(cwd) {
   if (fs.existsSync(path.join(cwd, '.claude'))) {
     return AGENT_TARGET_DIRS.claude;
   }
-  if (fs.existsSync(path.join(cwd, '.agents'))) {
-    return AGENT_TARGET_DIRS.agents;
-  }
+  // .agent/skills is the default for every other project (Copilot and unrecognized agents).
   return AGENT_TARGET_DIRS[DEFAULT_AGENT];
 }
 
@@ -131,15 +129,14 @@ function main() {
 
   const cwd = process.cwd();
   const targetBaseDir = resolveTargetBaseDir(cwd, args);
-  const packageRoot = fs.existsSync(path.join(__dirname, '..', skillFolders[0]))
-    ? path.join(__dirname, '..')
-    : __dirname;
+  const packageRoot = path.join(__dirname, '..');
 
   for (const folderName of skillFolders) {
     const srcDir = path.join(packageRoot, folderName);
     const destDir = path.join(targetBaseDir, folderName);
     if (!fs.existsSync(srcDir)) {
       console.error(`Source skill directory not found: ${srcDir}`);
+      process.exitCode = 1;
       continue;
     }
     copyDirRecursive(srcDir, destDir);
@@ -147,4 +144,4 @@ function main() {
   }
 }
 
-main();
+main();

package/package.json

@@ -1,32 +1,25 @@
 {
   "name": "@appxiom/mcp-skills",
-  "version": "1.0.0",
-  "description": "Appxiom MCP Skills for AI coding assistants and agent workflows",
+  "version": "1.0.1",
+  "description": "CLI to install Appxiom MCP skills (goal friction analysis, issue severity, quality score, occurrence telemetry) into a project's coding agent skills directory.",
+  "license": "UNLICENSED",
+  "author": "BasilGregory Software Labs Private Limited",
+  "homepage": "https://www.appxiom.com",
+  "publishConfig": {
+    "access": "public"
+  },
   "bin": {
-    "mcp-skills": "bin/cli.js",
-    "ax-mcp-skills": "bin/cli.js"
+    "appxiom-mcp-skills": "bin/cli.js"
   },
   "files": [
+    "CHANGELOG.md",
+    "bin",
     "goal-friction-analysis",
     "issue-severity-classification",
     "quality-score-interpretation",
-    "occurrence-telemetry-analysis",
-    "bin",
-    "README.md"
+    "occurrence-telemetry-analysis"
   ],
-  "scripts": {
-    "install-skills": "node ./bin/cli.js"
-  },
-  "keywords": [
-    "appxiom",
-    "mcp",
-    "skills",
-    "antigravity",
-    "ai-agent"
-  ],
-  "author": "Appxiom",
-  "license": "UNLICENSED",
-  "publishConfig": {
-    "access": "public"
+  "engines": {
+    "node": ">=18"
   }
-}
+}