@ifi/oh-pi-skills 0.4.4 → 0.5.0

package/README.md

@@ -5,6 +5,7 @@ On-demand skill packs for pi.
 ## What this package includes
 
 This package bundles reusable skills for common workflows, including areas like:
+
 - web search and fetch
 - debugging
 - git workflow help

package/package.json

@@ -1,27 +1,27 @@
 {
   "name": "@ifi/oh-pi-skills",
-  "version": "0.4.4",
+  "version": "0.5.0",
   "description": "On-demand skill packs for pi: web-search, debug-helper, git-workflow, and more.",
   "keywords": [
     "pi-package"
   ],
-  "pi": {
-    "skills": [
-      "./skills"
-    ]
+  "homepage": "https://github.com/ifiokjr/oh-pi/tree/main/packages/skills",
+  "bugs": {
+    "url": "https://github.com/ifiokjr/oh-pi/issues"
   },
-  "files": [
-    "skills",
-    "README.md"
-  ],
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ifiokjr/oh-pi.git",
     "directory": "packages/skills"
   },
-  "homepage": "https://github.com/ifiokjr/oh-pi/tree/main/packages/skills",
-  "bugs": {
-    "url": "https://github.com/ifiokjr/oh-pi/issues"
+  "files": [
+    "skills",
+    "README.md"
+  ],
+  "pi": {
+    "skills": [
+      "./skills"
+    ]
   }
 }

package/skills/claymorphism/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: claymorphism
-description:
-  Claymorphism design system skill. Use when building soft, puffy, clay-like UI components with
+description: Claymorphism design system skill. Use when building soft, puffy, clay-like UI components with
   large radii, dual inner shadows, and offset outer shadows.
 version: 1.0.0
 tags: [design, css, ui, claymorphism]
@@ -24,10 +23,10 @@ Reference: [references/tokens.css](references/tokens.css)
 @import "references/tokens.css";
 
 .clay-card {
-  background: var(--clay-bg-card);
-  border-radius: var(--clay-radius-lg);
-  box-shadow: var(--clay-shadow);
-  color: var(--clay-text);
+	background: var(--clay-bg-card);
+	border-radius: var(--clay-radius-lg);
+	box-shadow: var(--clay-shadow);
+	color: var(--clay-text);
 }
 ```
 
@@ -37,11 +36,11 @@ Reference: [references/tokens.css](references/tokens.css)
 
 ```css
 .clay-card {
-  background: var(--clay-bg-card);
-  border-radius: var(--clay-radius-lg);
-  box-shadow: var(--clay-shadow);
-  padding: 1.5rem;
-  color: var(--clay-text);
+	background: var(--clay-bg-card);
+	border-radius: var(--clay-radius-lg);
+	box-shadow: var(--clay-shadow);
+	padding: 1.5rem;
+	color: var(--clay-text);
 }
 ```
 
@@ -49,20 +48,20 @@ Reference: [references/tokens.css](references/tokens.css)
 
 ```css
 .clay-btn {
-  background: var(--clay-bg-button);
-  border: none;
-  border-radius: var(--clay-radius-pill);
-  box-shadow: var(--clay-shadow);
-  padding: 0.75rem 1.5rem;
-  color: var(--clay-text);
-  cursor: pointer;
-  transition: box-shadow 0.2s;
+	background: var(--clay-bg-button);
+	border: none;
+	border-radius: var(--clay-radius-pill);
+	box-shadow: var(--clay-shadow);
+	padding: 0.75rem 1.5rem;
+	color: var(--clay-text);
+	cursor: pointer;
+	transition: box-shadow 0.2s;
 }
 .clay-btn:hover {
-  box-shadow: var(--clay-shadow-elevated);
+	box-shadow: var(--clay-shadow-elevated);
 }
 .clay-btn:active {
-  box-shadow: var(--clay-shadow-pressed);
+	box-shadow: var(--clay-shadow-pressed);
 }
 ```
 
@@ -70,16 +69,16 @@ Reference: [references/tokens.css](references/tokens.css)
 
 ```css
 .clay-input {
-  background: var(--clay-bg);
-  border: none;
-  border-radius: var(--clay-radius);
-  box-shadow: var(--clay-shadow-pressed);
-  padding: 0.75rem 1rem;
-  color: var(--clay-text);
+	background: var(--clay-bg);
+	border: none;
+	border-radius: var(--clay-radius);
+	box-shadow: var(--clay-shadow-pressed);
+	padding: 0.75rem 1rem;
+	color: var(--clay-text);
 }
 .clay-input:focus {
-  outline: 2px solid var(--clay-accent);
-  outline-offset: 2px;
+	outline: 2px solid var(--clay-accent);
+	outline-offset: 2px;
 }
 ```
 
@@ -87,19 +86,19 @@ Reference: [references/tokens.css](references/tokens.css)
 
 ```css
 .clay-toggle {
-  width: 56px;
-  height: 30px;
-  background: var(--clay-bg-card);
-  border-radius: var(--clay-radius-pill);
-  box-shadow: var(--clay-shadow-pressed);
+	width: 56px;
+	height: 30px;
+	background: var(--clay-bg-card);
+	border-radius: var(--clay-radius-pill);
+	box-shadow: var(--clay-shadow-pressed);
 }
 .clay-toggle-knob {
-  width: 24px;
-  height: 24px;
-  background: var(--clay-bg);
-  border-radius: 50%;
-  box-shadow: var(--clay-shadow);
-  transition: transform 0.2s;
+	width: 24px;
+	height: 24px;
+	background: var(--clay-bg);
+	border-radius: 50%;
+	box-shadow: var(--clay-shadow);
+	transition: transform 0.2s;
 }
 ```
 
@@ -120,8 +119,8 @@ Reference: [references/tokens.css](references/tokens.css)
 
 ```css
 @media (prefers-contrast: more) {
-  .clay-card {
-    box-shadow: 0 0 0 2px var(--clay-text);
-  }
+	.clay-card {
+		box-shadow: 0 0 0 2px var(--clay-text);
+	}
 }
 ```

package/skills/claymorphism/references/tokens.css

@@ -1,52 +1,46 @@
 :root {
-  /* Backgrounds — soft, muted pastels */
-  --clay-bg: #f0e6db;
-  --clay-bg-card: #e8ddd4;
-  --clay-bg-button: #d4c4b0;
-  --clay-accent: #c4a882;
+	/* Backgrounds — soft, muted pastels */
+	--clay-bg: #f0e6db;
+	--clay-bg-card: #e8ddd4;
+	--clay-bg-button: #d4c4b0;
+	--clay-accent: #c4a882;
 
-  /* Radius — large, rounded, puffy */
-  --clay-radius: 20px;
-  --clay-radius-lg: 32px;
-  --clay-radius-pill: 50px;
+	/* Radius — large, rounded, puffy */
+	--clay-radius: 20px;
+	--clay-radius-lg: 32px;
+	--clay-radius-pill: 50px;
 
-  /* Shadows — dual inner + offset outer */
-  --clay-shadow:
-    8px 8px 16px rgba(0, 0, 0, 0.12),
-    inset -4px -4px 8px rgba(0, 0, 0, 0.08),
-    inset 4px 4px 8px rgba(255, 255, 255, 0.6);
-  --clay-shadow-elevated:
-    12px 12px 24px rgba(0, 0, 0, 0.15),
-    inset -6px -6px 12px rgba(0, 0, 0, 0.1),
-    inset 6px 6px 12px rgba(255, 255, 255, 0.7);
-  --clay-shadow-pressed:
-    2px 2px 6px rgba(0, 0, 0, 0.1),
-    inset -6px -6px 12px rgba(0, 0, 0, 0.12),
-    inset 6px 6px 12px rgba(255, 255, 255, 0.5);
+	/* Shadows — dual inner + offset outer */
+	--clay-shadow:
+		8px 8px 16px rgba(0, 0, 0, 0.12), inset -4px -4px 8px rgba(0, 0, 0, 0.08),
+		inset 4px 4px 8px rgba(255, 255, 255, 0.6);
+	--clay-shadow-elevated:
+		12px 12px 24px rgba(0, 0, 0, 0.15), inset -6px -6px 12px rgba(0, 0, 0, 0.1),
+		inset 6px 6px 12px rgba(255, 255, 255, 0.7);
+	--clay-shadow-pressed:
+		2px 2px 6px rgba(0, 0, 0, 0.1), inset -6px -6px 12px rgba(0, 0, 0, 0.12),
+		inset 6px 6px 12px rgba(255, 255, 255, 0.5);
 
-  /* Text */
-  --clay-text: #4a3f35;
-  --clay-text-muted: #8a7e72;
+	/* Text */
+	--clay-text: #4a3f35;
+	--clay-text-muted: #8a7e72;
 }
 
 /* Dark mode */
 [data-theme="dark"] {
-  --clay-bg: #2a2520;
-  --clay-bg-card: #352f28;
-  --clay-bg-button: #443c33;
-  --clay-accent: #6b5d4f;
-  --clay-shadow:
-    8px 8px 16px rgba(0, 0, 0, 0.35),
-    inset -4px -4px 8px rgba(0, 0, 0, 0.25),
-    inset 4px 4px 8px rgba(255, 255, 255, 0.05);
-  --clay-shadow-elevated:
-    12px 12px 24px rgba(0, 0, 0, 0.4),
-    inset -6px -6px 12px rgba(0, 0, 0, 0.3),
-    inset 6px 6px 12px rgba(255, 255, 255, 0.06);
-  --clay-shadow-pressed:
-    2px 2px 6px rgba(0, 0, 0, 0.3),
-    inset -6px -6px 12px rgba(0, 0, 0, 0.35),
-    inset 6px 6px 12px rgba(255, 255, 255, 0.04);
-  --clay-text: #d4c8bc;
-  --clay-text-muted: #8a7e72;
+	--clay-bg: #2a2520;
+	--clay-bg-card: #352f28;
+	--clay-bg-button: #443c33;
+	--clay-accent: #6b5d4f;
+	--clay-shadow:
+		8px 8px 16px rgba(0, 0, 0, 0.35), inset -4px -4px 8px rgba(0, 0, 0, 0.25),
+		inset 4px 4px 8px rgba(255, 255, 255, 0.05);
+	--clay-shadow-elevated:
+		12px 12px 24px rgba(0, 0, 0, 0.4), inset -6px -6px 12px rgba(0, 0, 0, 0.3),
+		inset 6px 6px 12px rgba(255, 255, 255, 0.06);
+	--clay-shadow-pressed:
+		2px 2px 6px rgba(0, 0, 0, 0.3), inset -6px -6px 12px rgba(0, 0, 0, 0.35),
+		inset 6px 6px 12px rgba(255, 255, 255, 0.04);
+	--clay-text: #d4c8bc;
+	--clay-text-muted: #8a7e72;
 }

package/skills/context7/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: context7
-description:
-  Search and query up-to-date documentation for any programming library via Context7 API. Use when
+description: Search and query up-to-date documentation for any programming library via Context7 API. Use when
   you need current docs, code examples, or API references for libraries and frameworks.
 ---
 

package/skills/context7/docs.js

@@ -1,13 +1,24 @@
 #!/usr/bin/env node
 
 const [libraryId, query] = process.argv.slice(2);
-if (!libraryId || !query) { console.error("Usage: docs.js <libraryId> <query>"); process.exit(1); }
+if (!libraryId || !query) {
+	console.error("Usage: docs.js <libraryId> <query>");
+	process.exit(1);
+}
 
 const res = await fetch("https://mcp.context7.com/mcp", {
-  method: "POST",
-  headers: { "Content-Type": "application/json", "Accept": "application/json, text/event-stream" },
-  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "query-docs", arguments: { libraryId, query } } })
+	body: JSON.stringify({
+		jsonrpc: "2.0",
+		id: 1,
+		method: "tools/call",
+		params: { name: "query-docs", arguments: { libraryId, query } },
+	}),
+	headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json" },
+	method: "POST",
 });
 const data = await res.json();
-if (data.error) { console.error("Error:", data.error.message); process.exit(1); }
+if (data.error) {
+	console.error("Error:", data.error.message);
+	process.exit(1);
+}
 console.log(data.result.content[0].text);

package/skills/context7/search.js

@@ -1,13 +1,24 @@
 #!/usr/bin/env node
 
 const [libraryName, query = libraryName] = process.argv.slice(2);
-if (!libraryName) { console.error("Usage: search.js <libraryName> [query]"); process.exit(1); }
+if (!libraryName) {
+	console.error("Usage: search.js <libraryName> [query]");
+	process.exit(1);
+}
 
 const res = await fetch("https://mcp.context7.com/mcp", {
-  method: "POST",
-  headers: { "Content-Type": "application/json", "Accept": "application/json, text/event-stream" },
-  body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "tools/call", params: { name: "resolve-library-id", arguments: { query, libraryName } } })
+	body: JSON.stringify({
+		jsonrpc: "2.0",
+		id: 1,
+		method: "tools/call",
+		params: { name: "resolve-library-id", arguments: { query, libraryName } },
+	}),
+	headers: { Accept: "application/json, text/event-stream", "Content-Type": "application/json" },
+	method: "POST",
 });
 const data = await res.json();
-if (data.error) { console.error("Error:", data.error.message); process.exit(1); }
+if (data.error) {
+	console.error("Error:", data.error.message);
+	process.exit(1);
+}
 console.log(data.result.content[0].text);

package/skills/debug-helper/SKILL.md

@@ -1,7 +1,6 @@
 ---
 name: debug-helper
-description:
-  Debug assistant for error analysis, log interpretation, and performance profiling. Use when user
+description: Debug assistant for error analysis, log interpretation, and performance profiling. Use when user
   encounters errors, crashes, or performance issues.
 ---
 

package/skills/devenv/REFERENCE.md

@@ -0,0 +1,233 @@
+# devenv Reference
+
+## Recommended `devenv.nix` layout
+
+This is the preferred structure, adapted from the monochange project. Adjust packages,
+scripts, and hooks for each project's needs.
+
+```nix
+{
+  pkgs,
+  lib,
+  config,
+  inputs,
+  ...
+}:
+
+let
+  extra = inputs.ifiokjr-nixpkgs.packages.${pkgs.stdenv.system};
+in
+{
+  packages =
+    with pkgs;
+    [
+      # Add project-specific packages here
+    ]
+    ++ lib.optionals stdenv.isDarwin [
+      coreutils
+    ];
+
+  enterShell = ''
+    # Keep shell entry fast. Only bootstrap missing toolchains here;
+    # explicit updates happen via install/update tasks instead of every shell.
+    export PATH="$DEVENV_ROOT/scripts:$PATH"
+  '';
+
+  # Disable dotenv if using direnv
+  dotenv.disableHint = true;
+
+  git-hooks = {
+    hooks = {
+      # Add pre-commit and pre-push hooks here
+    };
+  };
+
+  scripts = {
+    # Colon-namespaced scripts: build:*, test:*, lint:*, fix:*, etc.
+    "build:all" = {
+      exec = ''
+        set -e
+        # Project-specific build commands
+      '';
+      description = "Build everything.";
+      binary = "bash";
+    };
+
+    "test:all" = {
+      exec = ''
+        set -e
+        # Project-specific test commands
+      '';
+      description = "Run all tests.";
+      binary = "bash";
+    };
+
+    "lint:all" = {
+      exec = ''
+        set -e
+        # Project-specific lint commands
+      '';
+      description = "Run all checks.";
+      binary = "bash";
+    };
+
+    "fix:all" = {
+      exec = ''
+        set -e
+        # Project-specific autofix commands
+      '';
+      description = "Fix all autofixable problems.";
+      binary = "bash";
+    };
+
+    "docs:check" = {
+      exec = ''
+        set -e
+        mdt check
+      '';
+      description = "Check that shared documentation blocks are synchronized.";
+      binary = "bash";
+    };
+
+    "docs:update" = {
+      exec = ''
+        set -e
+        mdt update
+      '';
+      description = "Update shared documentation blocks.";
+      binary = "bash";
+    };
+  };
+}
+```
+
+## Script definition options
+
+Each script in the `scripts` block accepts:
+
+| Field         | Required    | Description                                          |
+| ------------- | ----------- | ---------------------------------------------------- |
+| `exec`        | Yes         | Shell command body. Use `"$@"` to forward arguments. |
+| `description` | Recommended | Short description shown by `devenv scan`.            |
+| `binary`      | Optional    | Shell binary (default: `bash`).                      |
+
+## Key variables available in `exec`
+
+- `$DEVENV_ROOT` — project root directory
+- `$DEVENV_PROFILE` — path to the devenv profile (contains `bin/`)
+- `$PWD` — current working directory
+
+## `enterShell` best practices
+
+- Keep it fast. Avoid expensive operations like full installs.
+- Only bootstrap missing toolchains (e.g. `rustup toolchain list | grep`).
+- Add custom script directories to PATH: `export PATH="$DEVENV_ROOT/scripts:$PATH"`.
+- Shell activation happens on every `devenv test` or `direnv` reload.
+
+## Git hooks in devenv
+
+Git hooks are defined under `git-hooks.hooks`. Each hook accepts:
+
+| Field            | Description                                            |
+| ---------------- | ------------------------------------------------------ |
+| `enable`         | Whether the hook is active                             |
+| `verbose`        | Print hook output                                      |
+| `pass_filenames` | Pass staged filenames to the entry command             |
+| `name`           | Display name                                           |
+| `description`    | What the hook does                                     |
+| `entry`          | Command to run (can reference `${pkgs.tool}/bin/tool`) |
+| `stages`         | `pre-commit` or `pre-push`                             |
+
+### Common hook patterns
+
+```nix
+"lint:all" = {
+  enable = true;
+  verbose = true;
+  pass_filenames = false;
+  name = "lint and test";
+  description = "Run lint and test before push.";
+  entry = "${config.env.DEVENV_PROFILE}/bin/lint:all && ${config.env.DEVENV_PROFILE}/bin/test:all";
+  stages = [ "pre-push" ];
+};
+
+"gitleaks" = {
+  enable = true;
+  verbose = true;
+  pass_filenames = true;
+  name = "secrets";
+  description = "Scan for leaked secrets.";
+  entry = "${pkgs.gitleaks}/bin/gitleaks protect --staged --verbose --redact";
+  stages = [ "pre-commit" ];
+};
+```
+
+## Processes and services
+
+devenv can manage background processes:
+
+```nix
+processes = {
+  server.exec = "cargo run --bin my-server";
+};
+
+services.postgres = {
+  enable = true;
+  package = pkgs.postgresql_16;
+  initialDatabases = [{ name = "myapp"; }];
+};
+```
+
+Run with:
+
+```bash
+devenv up            # Start all processes and services
+```
+
+## `devenv.yaml` inputs
+
+Use `devenv.yaml` to declare external flake inputs:
+
+```yaml
+inputs:
+  nixpkgs:
+    url: github:NixOS/nixpkgs/nixpkgs-unstable
+  ifiokjr-nixpkgs:
+    url: github:ifiokjr/nixpkgs
+```
+
+Then reference them in `devenv.nix` as `inputs.ifiokjr-nixpkgs.packages.${pkgs.stdenv.system}`.
+
+## Common commands reference
+
+| Command                   | Purpose                           |
+| ------------------------- | --------------------------------- |
+| `devenv test`             | Enter the development shell       |
+| `devenv shell <cmd>`      | Run a single command in the shell |
+| `devenv up`               | Start processes and services      |
+| `devenv update`           | Update flake inputs               |
+| `devenv gc`               | Garbage collect old generations   |
+| `devenv processes status` | Show running processes            |
+| `devenv scan`             | List available scripts            |
+
+## Troubleshooting
+
+### Command not found outside the shell
+
+If `pnpm`, `cargo`, or other tools are not available on your system PATH, always prefix:
+
+```bash
+devenv shell pnpm install
+devenv shell cargo build
+```
+
+### Stale environment
+
+```bash
+devenv test   # Re-enters the shell, re-evaluating enterShell
+```
+
+### Shell activation is slow
+
+Check that `enterShell` doesn't run expensive operations. Move one-time setup into named
+scripts like `install:toolchains` instead.