@abuswami1996/agent-md 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.2
+
+- Installed agent skills into each tool's documented `SKILL.md` directory.
+- Made Cursor skill installs self-contained under `.cursor/skills/agent-markdown/`.
+- Clarified Cursor extension installation via bundled VSIX until Open VSX publishing is complete.
+
 ## 0.1.0
 
 Initial MVP release candidate for the `agent-md` CLI.

package/README.md

@@ -16,15 +16,29 @@ npx agent-md init --agent cursor
 
 This creates local configuration, an agent skill file, schema metadata, starter examples, and VSCode/Cursor extension recommendations for `AbhinavSwaminathan.agent-md-preview`.
 
+Use the `--agent` flag to install the skill in the project-local location for your tool:
+
+- `cursor`: `.cursor/skills/agent-markdown/SKILL.md`
+- `claude-code`: `.claude/skills/agent-markdown/SKILL.md`
+- `codex`: `.agents/skills/agent-markdown/SKILL.md`
+- `opencode`: `.opencode/skills/agent-markdown/SKILL.md`
+- `all`: all supported project-local skill locations
+
 Install the published editor extension:
 
 ```bash
-cursor --install-extension AbhinavSwaminathan.agent-md-preview
+code --install-extension AbhinavSwaminathan.agent-md-preview
 ```
 
 Marketplace listing:
 [Agent Markdown Preview](https://marketplace.visualstudio.com/items?itemName=AbhinavSwaminathan.agent-md-preview)
 
+Cursor uses Open VSX for extension ID installs. Until Agent Markdown Preview is published there too, install the bundled VSIX:
+
+```bash
+npx agent-md vscode-extension --install --editor cursor
+```
+
 ## Commands
 
 ```bash
@@ -34,7 +48,7 @@ npx agent-md export examples/example.agent.md --format json
 npx agent-md vscode-extension
 ```
 
-`npx agent-md vscode-extension` prints local VSIX install instructions when the CLI package includes a bundled extension. The Marketplace extension is the preferred install path for most users.
+`npx agent-md vscode-extension` prints local VSIX install instructions when the CLI package includes a bundled extension. The Visual Studio Marketplace extension is the preferred install path for VSCode users; Cursor users should use the bundled VSIX until an Open VSX listing exists.
 
 ## Security
 

package/dist/index.js

@@ -308,7 +308,14 @@ function splitPropsAndBody(lines, sourcePath, startLine, diagnostics) {
 }
 
 // ../skill/src/index.ts
-var skillMarkdown = `# Agent Markdown Skill
+var skillName = "agent-markdown";
+var skillMarkdown = `---
+name: agent-markdown
+description: Create, validate, and revise local-first Agent Markdown .agent.md documents with charts, tables, maps, diagrams, metrics, tabs, local data, and safe workspace file references.
+license: MIT
+---
+
+# Agent Markdown Skill
 
 Use Agent Markdown when the user asks for interactive reports, dashboards, visual analysis, charts or tables in Markdown, or local visualization documents.
 
@@ -323,6 +330,12 @@ Rules:
 - Add frontmatter with format: agent-md and version: 0.1.
 - Run agent-md validate before considering a document complete.
 
+Supporting files in this skill directory:
+- agent-md.config.json: default runtime configuration.
+- schema.json: primitive reference schema.
+- components.json: registered component reference.
+- examples/example.agent.md: starter Agent Markdown document.
+
 Supported MVP primitives:
 - ::metric for KPI cards.
 - ::chart for line, bar, area, scatter, and pie charts.
@@ -614,6 +627,7 @@ function columnType(source, column) {
 // src/index.ts
 var program = new Command();
 var cliDir = path2.dirname(fileURLToPath(import.meta.url));
+var cliVersion = "0.1.2";
 var extensionId = "AbhinavSwaminathan.agent-md-preview";
 var viewerDistCandidates = [
   path2.resolve(cliDir, "../viewer-dist"),
@@ -623,19 +637,21 @@ var vsixCandidates = [
   path2.resolve(cliDir, "../agent-md-preview.vsix"),
   path2.resolve(cliDir, "../../vscode-extension/dist/agent-md-preview.vsix")
 ];
-program.name("agent-md").description("Local-first Agent Markdown runtime").version("0.1.0");
+program.name("agent-md").description("Local-first Agent Markdown runtime").version(cliVersion);
 program.command("init").option("--agent <agent>", "agent skill flavor", "generic").action(async (options) => {
   const root = process.cwd();
+  const agent = normalizeAgent(String(options.agent));
   await writeIfMissing(path2.join(root, "agent-md.config.json"), configJson());
   await fs2.mkdir(path2.join(root, ".agent-md"), { recursive: true });
   await fs2.mkdir(path2.join(root, "examples"), { recursive: true });
-  await writeIfMissing(path2.join(root, ".agent-md", "skill.md"), skillMarkdown);
+  const installedSkillPaths = await installAgentSkill(root, agent);
   await writeIfMissing(path2.join(root, ".agent-md", "schema.json"), schemaJson());
   await writeIfMissing(path2.join(root, ".agent-md", "components.json"), componentsJson());
   await writeIfMissing(path2.join(root, "examples", "example.agent.md"), exampleAgentMarkdown);
-  if (["cursor", "vscode"].includes(String(options.agent).toLowerCase())) await mergeVsCodeRecommendation(root);
+  if (["cursor", "vscode"].includes(agent)) await mergeVsCodeRecommendation(root);
   console.log(pc.green("Agent Markdown project initialized."));
-  if (["cursor", "vscode"].includes(String(options.agent).toLowerCase())) {
+  for (const installedPath of installedSkillPaths) console.log(pc.gray(`Agent skill installed: ${path2.relative(root, installedPath)}`));
+  if (["cursor", "vscode"].includes(agent)) {
     console.log(pc.gray(`Recommended extension added: ${extensionId}`));
     console.log(pc.gray("Open an .agent.md file and run: Agent Markdown: Open Preview"));
     console.log(pc.gray("Browser fallback: npx agent-md serve"));
@@ -710,6 +726,36 @@ async function writeIfMissing(file, content) {
     if (error.code !== "EEXIST") throw error;
   }
 }
+async function installAgentSkill(root, agent) {
+  const skillPaths = skillInstallPaths(root, agent);
+  for (const skillPath of skillPaths) {
+    const skillDir = path2.dirname(skillPath);
+    await fs2.mkdir(path2.join(skillDir, "examples"), { recursive: true });
+    await writeIfMissing(skillPath, skillMarkdown);
+    await writeIfMissing(path2.join(skillDir, "agent-md.config.json"), configJson());
+    await writeIfMissing(path2.join(skillDir, "schema.json"), schemaJson());
+    await writeIfMissing(path2.join(skillDir, "components.json"), componentsJson());
+    await writeIfMissing(path2.join(skillDir, "examples", "example.agent.md"), exampleAgentMarkdown);
+  }
+  return skillPaths;
+}
+function normalizeAgent(agent) {
+  return agent.toLowerCase().trim().replace(/[\s_]+/g, "-");
+}
+function skillInstallPaths(root, agent) {
+  const relativeRoots = {
+    cursor: [".cursor/skills"],
+    vscode: [".agents/skills"],
+    "claude-code": [".claude/skills"],
+    claude: [".claude/skills"],
+    codex: [".agents/skills"],
+    opencode: [".opencode/skills"],
+    generic: [".agents/skills"],
+    all: [".cursor/skills", ".claude/skills", ".agents/skills", ".opencode/skills"]
+  };
+  const roots = relativeRoots[agent] ?? relativeRoots.generic;
+  return roots.map((relativeRoot) => path2.join(root, relativeRoot, skillName, "SKILL.md"));
+}
 async function mergeVsCodeRecommendation(root) {
   const vscodeDir = path2.join(root, ".vscode");
   const extensionsPath = path2.join(vscodeDir, "extensions.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abuswami1996/agent-md",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local-first Agent Markdown runtime, validator, browser viewer, and agent skill installer.",
   "license": "MIT",
   "author": "Abhinav Swaminathan",
@@ -22,12 +22,29 @@
     "cursor"
   ],
   "type": "module",
-  "engines": { "node": ">=20" },
-  "bin": { "agent-md": "dist/index.js" },
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "agent-md": "dist/index.js"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "exports": { ".": { "types": "./dist/index.d.ts", "import": "./dist/index.js" } },
-  "files": ["dist", "viewer-dist", "agent-md-preview.vsix", "README.md", "LICENSE", "CHANGELOG.md", "package.json"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "viewer-dist",
+    "agent-md-preview.vsix",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "package.json"
+  ],
   "scripts": {
     "build": "tsup src/index.ts --format esm --external commander --external picocolors --external fast-glob --external chokidar --external ws --external yaml --external papaparse --external zod && tsc src/index.ts --ignoreConfig --emitDeclarationOnly --declaration --outDir dist --module ESNext --moduleResolution Bundler --target ES2022 --skipLibCheck --strict && rm -rf viewer-dist && cp -R ../viewer/dist viewer-dist && if [ -f ../vscode-extension/dist/agent-md-preview.vsix ]; then cp ../vscode-extension/dist/agent-md-preview.vsix agent-md-preview.vsix; fi",
     "prepack": "node -e \"const fs=require('fs'); for (const p of ['dist/index.js','dist/index.d.ts','viewer-dist/index.html','agent-md-preview.vsix','README.md','LICENSE','CHANGELOG.md']) if (!fs.existsSync(p)) { console.error('Missing publish artifact: '+p); process.exit(1); }\""