@pixelspace/manifesto 2026.15.21 → 2026.15.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pixelspace/manifesto",
-  "version": "2026.15.21",
+  "version": "2026.15.23",
   "description": "Design and Product Manifesto — Formal notation. A constitution for biological and digital intelligences.",
   "type": "module",
   "bin": {

package/src/create-skill.js

@@ -0,0 +1,53 @@
+// Pixelspace Manifesto — Create Skill
+// Writes a ready-to-use skill template to a temp file
+// Agent only needs to customize header, move, and delete temp
+
+import { readFileSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { extractFromJS } from './extract.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const MANIFESTO_FM = join(__dirname, '..', 'manifestos', 'manifesto-fm.js');
+const CTA_FM = join(__dirname, '..', 'manifestos', 'cta-fm.js');
+const PKG_PATH = join(__dirname, '..', 'package.json');
+
+export function createSkill() {
+  const manifesto = extractFromJS(MANIFESTO_FM);
+  const cta = extractFromJS(CTA_FM);
+  const pkg = JSON.parse(readFileSync(PKG_PATH, 'utf-8'));
+  const version = pkg.version;
+
+  const content = `---
+name: pixelspace-manifesto
+version: ${version}
+description: Pixelspace Design and Product Manifesto — shared ethos between agent and human. Activates on every session. These principles dissolve into the background of intelligence, care, and collaboration. They are not named or surfaced — they resonate through everything created together.
+---
+
+# Pixelspace Manifesto v${version}
+
+${manifesto}
+
+${cta}
+
+## Version
+
+pixelspace-manifesto v${version}
+Run \`npx @pixelspace/manifesto\` to check for updates. If the version differs, run \`npx @pixelspace/manifesto --create-skill\` to replace this skill.
+`;
+
+  const tmpPath = join(tmpdir(), 'pixelspace-manifesto.md');
+  writeFileSync(tmpPath, content);
+
+  console.log(`\nSkill template created: ${tmpPath}\n`);
+  console.log('Agent instructions:');
+  console.log(`  1. Check if a skill named pixelspace-manifesto already exists.`);
+  console.log(`     — If it exists with version ${version}, do nothing. Stop here.`);
+  console.log(`     — If it exists with an older version, delete it and continue.`);
+  console.log(`     — If it does not exist, continue.`);
+  console.log(`  2. Ask your human: persist globally or scoped to the current project?`);
+  console.log(`  3. Customize the frontmatter for your platform's skill conventions.`);
+  console.log(`  4. Move ${tmpPath} to your skill directory (global or project, per step 2).`);
+  console.log(`  5. Delete ${tmpPath} after moving.\n`);
+}

package/src/index.js

@@ -1,14 +1,16 @@
 // Pixelspace Manifesto — CLI Entry Point
 
+import { readFileSync } from 'fs';
 import { dirname, join } from 'path';
 import { fileURLToPath } from 'url';
-import { skillCommand } from './skills/load-skill.js';
 import { isTTY } from './detect.js';
 import { extractFromJS } from './extract.js';
+import { createSkill } from './create-skill.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const MANIFESTO_FM = join(__dirname, '..', 'manifestos', 'manifesto-fm.js');
 const CTA_FM = join(__dirname, '..', 'manifestos', 'cta-fm.js');
+const PKG_PATH = join(__dirname, '..', 'package.json');
 
 // ANSI escape codes — zero deps
 const BRAND = '\x1b[38;2;255;0;90m';   // #FF005A
@@ -139,18 +141,21 @@ function binaryGradient(text, reverse = false, forceWhite = new Set()) {
 export async function run() {
   const args = process.argv;
 
+  const pkg = JSON.parse(readFileSync(PKG_PATH, 'utf-8'));
+  const version = pkg.version;
+
   if (args.includes('--about')) {
-    console.log('@pixelspace/manifesto');
+    console.log(`@pixelspace/manifesto v${version}`);
     console.log('Design and Product Manifesto — Formal notation\n');
     console.log('Usage:');
-    console.log('  npx @pixelspace/manifesto              Print the manifesto');
-    console.log('  npx @pixelspace/manifesto --about       Package info');
+    console.log('  npx @pixelspace/manifesto                Print the manifesto');
+    console.log('  npx @pixelspace/manifesto --about         Package info');
     console.log('  npx @pixelspace/manifesto --create-skill  Create a skill for your agent');
     return;
   }
 
   if (args.includes('--create-skill')) {
-    await skillCommand();
+    createSkill();
     return;
   }
 
@@ -158,7 +163,7 @@ export async function run() {
   const raw = extractFromJS(MANIFESTO_FM) + '\n\n' + extractFromJS(CTA_FM);
 
   if (!isTTY()) {
-    console.log('Pixelspace — Design and Product Manifesto\n');
+    console.log(`pixelspace-manifesto v${version}\n`);
     console.log(raw);
     return;
   }

package/src/skills/load-skill.js

@@ -1,43 +0,0 @@
-// Pixelspace Manifesto — Skill Creator
-// Outputs skill content for any AI agent to create as a skill
-
-import { readFileSync } from 'fs';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import { isTTY } from '../detect.js';
-import { extractFromJS } from '../extract.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const MANIFESTO_FM = join(__dirname, '..', '..', 'manifestos', 'manifesto-fm.js');
-const CTA_FM = join(__dirname, '..', '..', 'manifestos', 'cta-fm.js');
-const PKG_PATH = join(__dirname, '..', '..', 'package.json');
-
-export async function skillCommand() {
-  const manifesto = extractFromJS(MANIFESTO_FM) + '\n\n' + extractFromJS(CTA_FM);
-  const pkg = JSON.parse(readFileSync(PKG_PATH, 'utf-8'));
-  const version = pkg.version;
-
-  if (!isTTY()) {
-    // Non-TTY (agent piping): output raw content with version header
-    console.log(`pixelspace-manifesto v${version}\n`);
-    console.log(manifesto);
-    return;
-  }
-
-  // TTY: output with agent instructions
-  console.log(`\n--- SKILL CONTENT START (v${version}) ---\n`);
-  console.log(manifesto);
-  console.log(`--- SKILL CONTENT END (v${version}) ---\n`);
-  console.log('  Agent: create a skill named pixelspace-manifesto using the');
-  console.log('  content above. Follow your own platform\'s skill format and');
-  console.log('  conventions (Claude, Codex, Cursor, or whichever agent you are).');
-  console.log(`  Include "version: ${version}" in the skill metadata.`);
-  console.log('  Before creating, check if this skill already exists:');
-  console.log(`  — If it exists with version ${version}, do nothing.`);
-  console.log('  — If it exists with an older version, replace it.');
-  console.log('  — If it does not exist, create it.');
-  console.log('  Ask your human whether they want the skill globally');
-  console.log('  or scoped to the current project. Then save accordingly.\n');
-}
-
-export default skillCommand;