@laith-wallace/crisp 1.0.0

package/README.md

@@ -0,0 +1,66 @@
+# CRISP — Design Intelligence for AI Agents
+
+Five skills that give your AI agent a senior product designer's eye. Drop them into Claude, Cursor, Copilot, or Gemini and get structured design reviews, feature specs, and developer handoffs grounded in the CRISP framework.
+
+**CRISP** = Contextual · Responsive · Intelligent · Seamless · Powerful
+
+---
+
+## Skills
+
+| Command | What it does |
+|---------|-------------|
+| `/crisp-teach` | Onboards the AI to your product — users, design system, benchmarks. Writes `.crisp.md` which all other commands read automatically. Run once per project. |
+| `/crisp-review` | 30-second scan. Returns a grade A–F and your top 3 issues with specific fixes. Use during rapid iteration. |
+| `/crisp-audit` | Full CRISP evaluation. Scores all five dimensions, rates violations P0–P3, and benchmarks against Stripe, Linear, Notion, Asana, and Slack. |
+| `/feature-design` | Designs a new feature from scratch using CRISP principles — user flows, component decisions, compliance checks, and open questions. |
+| `/handoff` | Converts a reviewed design into a developer-ready spec — states, tokens, interactions, edge cases, accessibility, and exact copy. |
+
+---
+
+## Install
+
+### Claude Code
+```bash
+npx skills add laith-wallace/crisp
+```
+
+### Cursor
+Copy the contents of `.cursor/rules/` into your project's `.cursor/rules/` folder.
+
+### Other agents
+- **GitHub Copilot / Antigravity** — copy from `.agents/skills/`
+- **Gemini** — copy from `.gemini/skills/`
+- **Manual** — copy any `.md` file from `files/` and add it to your agent's context
+
+---
+
+## How it works
+
+Run `/crisp-teach` first. The AI interviews you about your product, users, and design system, then writes a `.crisp.md` file to your project root. Every subsequent CRISP command reads that file automatically — so reviews and specs are grounded in your specific context, not generic advice.
+
+```
+/crisp-teach   →  writes .crisp.md
+/crisp-review  →  reads .crisp.md, returns grade + top 3 issues
+/crisp-audit   →  reads .crisp.md, full scored evaluation
+/feature-design → reads .crisp.md, produces user flow + spec
+/handoff       →  reads .crisp.md, produces dev-ready spec
+```
+
+---
+
+## The CRISP Framework
+
+| Dimension | The test |
+|-----------|----------|
+| **C**ontextual | Can the user tell where they are and what this page does within 5 seconds? |
+| **R**esponsive | Does the UI update immediately on every interaction? |
+| **I**ntelligent | Are we showing insight, not raw data? |
+| **S**eamless | Are we fitting into their day — not forcing them into ours? |
+| **P**owerful | Is complexity hidden appropriately for each user type? |
+
+---
+
+## License
+
+MIT

package/bin/crisp.mjs

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+import * as p from '@clack/prompts';
+import chalk from 'chalk';
+import figlet from 'figlet';
+import { existsSync, mkdirSync, copyFileSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+
+const LIME = '#c8ff3c';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(__dirname, '..');
+
+const SKILLS = [
+  { value: 'crisp-teach',    label: '/crisp-teach',    hint: 'Onboard your AI to your product — writes .crisp.md' },
+  { value: 'crisp-review',   label: '/crisp-review',   hint: '30-second design scan, A–F grade, top 3 issues' },
+  { value: 'crisp-audit',    label: '/crisp-audit',    hint: 'Full CRISP evaluation across 5 dimensions' },
+  { value: 'feature-design', label: '/feature-design', hint: 'Design new features using CRISP principles' },
+  { value: 'handoff',        label: '/handoff',        hint: 'Convert designs to developer-ready specs' },
+];
+
+const AGENTS = [
+  {
+    value: 'claude',
+    label: 'Claude Code',
+    hint: '~/.claude/skills/',
+    src: join(PKG_ROOT, '.claude', 'skills'),
+    dest: () => join(homedir(), '.claude', 'skills'),
+    detect: () => existsSync(join(homedir(), '.claude')),
+  },
+  {
+    value: 'cursor',
+    label: 'Cursor',
+    hint: '.cursor/rules/ (current project)',
+    src: join(PKG_ROOT, '.cursor', 'rules'),
+    dest: () => join(process.cwd(), '.cursor', 'rules'),
+    detect: () => existsSync(join(process.cwd(), '.cursor')) || existsSync(join(homedir(), '.cursor')),
+  },
+  {
+    value: 'antigravity',
+    label: 'Antigravity',
+    hint: '~/.agents/skills/',
+    src: join(PKG_ROOT, '.agents', 'skills'),
+    dest: () => join(homedir(), '.agents', 'skills'),
+    detect: () => existsSync(join(homedir(), '.agents')),
+  },
+  {
+    value: 'gemini',
+    label: 'Gemini CLI',
+    hint: '~/.gemini/skills/',
+    src: join(PKG_ROOT, '.gemini', 'skills'),
+    dest: () => join(homedir(), '.gemini', 'skills'),
+    detect: () => existsSync(join(homedir(), '.gemini')),
+  },
+  {
+    value: 'manual',
+    label: 'Manual copy',
+    hint: 'Show file paths — copy yourself',
+    src: join(PKG_ROOT, 'files'),
+    dest: () => null,
+    detect: () => false,
+  },
+];
+
+function logo() {
+  const art = figlet.textSync('CRISP', { font: 'ANSI Shadow' });
+  return chalk.hex(LIME)(art);
+}
+
+function cancelIfNeeded(value) {
+  if (p.isCancel(value)) {
+    p.cancel('Installation cancelled.');
+    process.exit(0);
+  }
+  return value;
+}
+
+async function main() {
+  console.log('\n' + logo());
+  console.log(chalk.hex(LIME).dim('  Design Intelligence for AI Agents\n'));
+
+  p.intro(chalk.hex(LIME)('CRISP Installer'));
+
+  // Skill selection
+  const selectedSkills = cancelIfNeeded(
+    await p.multiselect({
+      message: 'Which skills do you want to install?',
+      options: SKILLS.map(s => ({ ...s, initialChecked: true })),
+      initialValues: SKILLS.map(s => s.value),
+      required: true,
+    })
+  );
+
+  // Agent selection — pre-select detected agents
+  const detectedValues = AGENTS.filter(a => a.detect()).map(a => a.value);
+
+  const selectedAgentValues = cancelIfNeeded(
+    await p.multiselect({
+      message: 'Install to which agents?',
+      options: AGENTS.map(a => ({
+        value: a.value,
+        label: a.label,
+        hint: a.detect()
+          ? chalk.hex(LIME)('✓ detected') + chalk.dim('  ' + a.hint)
+          : chalk.dim(a.hint),
+      })),
+      initialValues: detectedValues.length > 0 ? detectedValues : ['manual'],
+      required: true,
+    })
+  );
+
+  const selectedAgents = AGENTS.filter(a => selectedAgentValues.includes(a.value));
+  const results = {};
+
+  const spinner = p.spinner();
+  spinner.start('Installing skills…');
+
+  for (const agent of selectedAgents) {
+    results[agent.value] = { agent, files: [] };
+
+    if (agent.value === 'manual') continue;
+
+    const dest = agent.dest();
+    try {
+      mkdirSync(dest, { recursive: true });
+    } catch (e) {
+      results[agent.value].error = `Could not create ${dest}: ${e.message}`;
+      continue;
+    }
+
+    for (const skill of selectedSkills) {
+      const src = join(agent.src, skill + '.md');
+      const dst = join(dest, skill + '.md');
+      try {
+        copyFileSync(src, dst);
+        results[agent.value].files.push({ skill, path: dst, ok: true });
+      } catch (e) {
+        results[agent.value].files.push({ skill, path: dst, ok: false, error: e.message });
+      }
+    }
+  }
+
+  spinner.stop(chalk.hex(LIME)('Skills installed'));
+
+  // Summary
+  for (const [, { agent, files, error }] of Object.entries(results)) {
+    if (agent.value === 'manual') {
+      console.log('\n' + chalk.dim('  ── Manual copy ──'));
+      for (const skill of selectedSkills) {
+        const src = join(agent.src, skill + '.md');
+        console.log('  ' + chalk.dim(src));
+      }
+      continue;
+    }
+
+    if (error) {
+      console.log('\n' + chalk.red(`  ✗ ${agent.label}: ${error}`));
+      continue;
+    }
+
+    console.log('\n' + chalk.dim(`  ── ${agent.label} ──`));
+    for (const f of files) {
+      if (f.ok) {
+        console.log('  ' + chalk.hex(LIME)('✓') + ' ' + chalk.dim(f.path));
+      } else {
+        console.log('  ' + chalk.red('✗') + ' ' + f.skill + chalk.red(` — ${f.error}`));
+      }
+    }
+  }
+
+  p.outro(
+    chalk.hex(LIME)('Done.') +
+    chalk.dim(' Run ') +
+    chalk.hex(LIME)('/crisp-teach') +
+    chalk.dim(' in your agent to get started.')
+  );
+}
+
+main().catch(e => {
+  console.error(chalk.red('Error: ' + e.message));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@laith-wallace/crisp",
+  "version": "1.0.0",
+  "description": "CRISP design intelligence skills for AI agents",
+  "type": "module",
+  "bin": {
+    "crisp": "./bin/crisp.mjs"
+  },
+  "files": [
+    "bin/",
+    ".claude/skills/",
+    ".cursor/rules/",
+    ".agents/skills/",
+    ".gemini/skills/"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.9.0",
+    "chalk": "^5.3.0",
+    "figlet": "^1.7.0"
+  },
+  "keywords": ["design", "ux", "ai", "skills", "claude", "cursor", "crisp"],
+  "author": "Laith Wallace",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/laith-wallace/crisp"
+  }
+}