incitaciones 0.1.0 → 0.2.0

package/README.md

@@ -2,7 +2,28 @@
 
 A collection of reusable prompts and best practices for CLI LLM tools.
 
-## Install
+## Quick Install
+
+### Via npm / npx (recommended)
+
+```bash
+# Install as pi package (native skills, best UX):
+pi install npm:incitaciones
+
+# Or install across all tools (pi, Claude Code, Amp, Gemini CLI, etc.):
+npx incitaciones install
+
+# Install only the essentials bundle:
+npx incitaciones install --bundle essentials
+
+# List available skills:
+npx incitaciones list
+
+# Show skill details:
+npx incitaciones info commit
+```
+
+### From git
 
 Clone and install prompts as skills for pi CLI, Claude Code, Amp, Gemini CLI, and other tools:
 
@@ -49,10 +70,12 @@ Skills are installed to `~/.agents/skills/` (or project `.agents/skills/`) and c
 
 ### Native pi package install
 
-This repository now includes a `package.json` with a `pi` manifest, so pi can install it directly as a package:
+This repository is published as an npm package with a `pi` manifest, so pi can install it directly:
 
 ```bash
-pi install https://github.com/charly-vibes/incitaciones
+pi install npm:incitaciones
+# or from git
+pi install git:github.com/charly-vibes/incitaciones
 # or from a local clone
 pi install .
 ```
@@ -111,6 +134,8 @@ just validate-distilled       # Validate distilled prompts
 just list-bundles             # Show available bundles
 just sync-manifest            # Validate manifest references and update content/manifest.json version
 just generate-skill NAME      # Preview SKILL.md output for a prompt
+just nucleus-roundtrip NAME   # Use pi to compile+decompile a prompt via Nucleus lambda
+just compare-nucleus NAME     # Diff a Nucleus roundtrip against the canonical distilled prompt
 just analyze-traces PATH      # Analyze trace exports from agent tools
 just analyze-traces-auto      # Auto-detect local CLI history locations
 just trace-insights           # Process traces and write insight artifacts
@@ -342,6 +367,23 @@ just validate
 # Reports any issues
 ```
 
+**Experimenting with Nucleus lambda roundtrips:**
+```bash
+just nucleus-roundtrip distill-prompt
+# Uses pi -p to compile the distilled prompt to lambda and decompile it back to prose
+# Writes content/compiled/nucleus/distill-prompt.lambda.md
+# Writes content/compiled/nucleus/distill-prompt.roundtrip.md
+just compare-nucleus distill-prompt
+# Diffs the roundtrip prose against the canonical distilled prompt
+```
+
+Pass extra pi flags through when needed:
+```bash
+just nucleus-roundtrip distill-prompt --model sonnet:high
+```
+
+The `content/compiled/nucleus/` directory is experimental. It is intentionally kept outside `content/distilled/` so these comparison artifacts do not affect installation or packaged skills.
+
 ## What Goes Here?
 
 ✅ **Good candidates:**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "incitaciones",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Reusable prompts and skills for CLI LLM tools, with native pi package support.",
   "repository": {
     "type": "git",

package/pi-package/README.md

@@ -7,3 +7,11 @@ Do not edit files here by hand.
 
 - `skills/` contains pi-compatible Agent Skills
 - `prompts/` contains pi prompt templates
+
+## Install from npm
+
+```bash
+pi install npm:incitaciones
+```
+
+This package is published as [`incitaciones` on npm](https://www.npmjs.com/package/incitaciones).