@hasna/skills 0.1.19 → 0.1.20

package/dist/index.js

@@ -3,6 +3,94 @@
 import { existsSync, readFileSync, readdirSync } from "fs";
 import { join } from "path";
 import { homedir } from "os";
+
+// src/lib/search.ts
+function editDistance(a, b) {
+  if (a === b)
+    return 0;
+  if (a.length === 0)
+    return b.length;
+  if (b.length === 0)
+    return a.length;
+  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
+  const curr = new Array(b.length + 1);
+  for (let i = 1;i <= a.length; i++) {
+    curr[0] = i;
+    for (let j = 1;j <= b.length; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
+    }
+    prev.splice(0, prev.length, ...curr);
+  }
+  return prev[b.length];
+}
+function fuzzyMatchScore(word, target) {
+  if (target.includes(word))
+    return 1;
+  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
+  for (const token of tokens) {
+    if (token.startsWith(word))
+      return 0.6;
+  }
+  if (word.length >= 3) {
+    const maxDist = word.length <= 3 ? 1 : 2;
+    for (const token of tokens) {
+      if (Math.abs(token.length - word.length) <= maxDist) {
+        const dist = editDistance(word, token);
+        if (dist <= maxDist)
+          return 0.4;
+      }
+    }
+  }
+  return 0;
+}
+function searchSkills(query) {
+  const words = query.toLowerCase().split(/\s+/).filter(Boolean);
+  if (words.length === 0)
+    return [];
+  const scored = [];
+  for (const skill of loadRegistry()) {
+    const nameLower = skill.name.toLowerCase();
+    const displayNameLower = skill.displayName.toLowerCase();
+    const descriptionLower = skill.description.toLowerCase();
+    const tagsLower = skill.tags.map((t) => t.toLowerCase());
+    const tagsCombined = tagsLower.join(" ");
+    let score = 0;
+    let allWordsMatch = true;
+    for (const word of words) {
+      let wordScore = 0;
+      const nameMatch = fuzzyMatchScore(word, nameLower);
+      if (nameMatch > 0)
+        wordScore += 10 * nameMatch;
+      const displayMatch = fuzzyMatchScore(word, displayNameLower);
+      if (displayMatch > 0)
+        wordScore += 7 * displayMatch;
+      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
+      if (tagMatch > 0)
+        wordScore += 5 * tagMatch;
+      const descMatch = fuzzyMatchScore(word, descriptionLower);
+      if (descMatch > 0)
+        wordScore += 2 * descMatch;
+      if (wordScore === 0) {
+        allWordsMatch = false;
+        break;
+      }
+      score += wordScore;
+    }
+    if (allWordsMatch && score > 0) {
+      scored.push({ skill, score });
+    }
+  }
+  scored.sort((a, b) => b.score - a.score);
+  return scored.map((s) => s.skill);
+}
+function findSimilarSkills(query, maxResults = 3) {
+  const q = query.toLowerCase();
+  const scored = loadRegistry().map((s) => ({ name: s.name, dist: editDistance(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
+  return scored.slice(0, maxResults).map((s) => s.name);
+}
+
+// src/lib/registry.ts
 var CATEGORIES = [
   "Development Tools",
   "Business & Marketing",
@@ -44,6 +132,21 @@ var SKILLS = [
     category: "Development Tools",
     tags: ["code", "linting", "formatting", "quality"]
   },
+  {
+    name: "commitpush",
+    displayName: "Commit Push",
+    description: "Create logical commits from repo changes and push directly to the main branch",
+    category: "Development Tools",
+    tags: ["git", "commit", "push", "automation"]
+  },
+  {
+    name: "commitpushpr",
+    displayName: "Commit Push PR",
+    description: "Create logical commits, push a feature branch, and open a GitHub pull request",
+    category: "Development Tools",
+    tags: ["git", "commit", "pull-request", "github", "automation"],
+    dependencies: ["commitpush"]
+  },
   {
     name: "consolelog",
     displayName: "Console Log",
@@ -205,6 +308,13 @@ var SKILLS = [
     category: "Development Tools",
     tags: ["mcp", "builder", "scaffold", "server"]
   },
+  {
+    name: "monitor",
+    displayName: "Monitor",
+    description: "Operate the open-monitor MCP for machine health, processes, cron jobs, and cleanup workflows",
+    category: "Development Tools",
+    tags: ["monitoring", "mcp", "processes", "operations"]
+  },
   {
     name: "npmpublish",
     displayName: "NPM Publish",
@@ -255,6 +365,13 @@ var SKILLS = [
     category: "Development Tools",
     tags: ["terraform", "iac", "infrastructure", "devops"]
   },
+  {
+    name: "tmux-session",
+    displayName: "Tmux Session",
+    description: "Create and manage grouped tmux sessions with workspace-aware naming and window layout guidance",
+    category: "Development Tools",
+    tags: ["tmux", "terminal", "sessions", "workspace"]
+  },
   {
     name: "validate-config",
     displayName: "Validate Config",
@@ -857,6 +974,34 @@ var SKILLS = [
     category: "Data & Analysis",
     tags: ["kpi", "digest", "metrics", "reporting"]
   },
+  {
+    name: "read-csv",
+    displayName: "Read CSV",
+    description: "Parse CSV files into structured JSON with delimiter and encoding detection",
+    category: "Data & Analysis",
+    tags: ["csv", "parsing", "tabular", "data"]
+  },
+  {
+    name: "read-excel",
+    displayName: "Read Excel",
+    description: "Parse XLS and XLSX workbooks into structured JSON with sheet and formatted cell metadata",
+    category: "Data & Analysis",
+    tags: ["excel", "spreadsheet", "xlsx", "data"]
+  },
+  {
+    name: "read-image",
+    displayName: "Read Image",
+    description: "Analyze local or remote images with Claude vision and extract visible text and visual structure",
+    category: "Data & Analysis",
+    tags: ["image", "vision", "ocr", "analysis"]
+  },
+  {
+    name: "read-pdf",
+    displayName: "Read PDF",
+    description: "Extract text and structured content from PDF files with chunked Claude document analysis",
+    category: "Data & Analysis",
+    tags: ["pdf", "documents", "extraction", "analysis"]
+  },
   {
     name: "spreadsheet-cleanroom",
     displayName: "Spreadsheet Cleanroom",
@@ -1542,85 +1687,6 @@ function clearRegistryCache() {
 function getSkillsByCategory(category) {
   return loadRegistry().filter((s) => s.category === category);
 }
-function editDistance(a, b) {
-  if (a === b)
-    return 0;
-  if (a.length === 0)
-    return b.length;
-  if (b.length === 0)
-    return a.length;
-  const prev = Array.from({ length: b.length + 1 }, (_, i) => i);
-  const curr = new Array(b.length + 1);
-  for (let i = 1;i <= a.length; i++) {
-    curr[0] = i;
-    for (let j = 1;j <= b.length; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      curr[j] = Math.min(curr[j - 1] + 1, prev[j] + 1, prev[j - 1] + cost);
-    }
-    prev.splice(0, prev.length, ...curr);
-  }
-  return prev[b.length];
-}
-function fuzzyMatchScore(word, target) {
-  if (target.includes(word))
-    return 1;
-  const tokens = target.split(/[\s\-_]+/).filter(Boolean);
-  for (const token of tokens) {
-    if (token.startsWith(word))
-      return 0.6;
-  }
-  if (word.length >= 3) {
-    const maxDist = word.length <= 3 ? 1 : 2;
-    for (const token of tokens) {
-      if (Math.abs(token.length - word.length) <= maxDist) {
-        const dist = editDistance(word, token);
-        if (dist <= maxDist)
-          return 0.4;
-      }
-    }
-  }
-  return 0;
-}
-function searchSkills(query) {
-  const words = query.toLowerCase().split(/\s+/).filter(Boolean);
-  if (words.length === 0)
-    return [];
-  const scored = [];
-  for (const skill of loadRegistry()) {
-    const nameLower = skill.name.toLowerCase();
-    const displayNameLower = skill.displayName.toLowerCase();
-    const descriptionLower = skill.description.toLowerCase();
-    const tagsLower = skill.tags.map((t) => t.toLowerCase());
-    const tagsCombined = tagsLower.join(" ");
-    let score = 0;
-    let allWordsMatch = true;
-    for (const word of words) {
-      let wordScore = 0;
-      const nameMatch = fuzzyMatchScore(word, nameLower);
-      if (nameMatch > 0)
-        wordScore += 10 * nameMatch;
-      const displayMatch = fuzzyMatchScore(word, displayNameLower);
-      if (displayMatch > 0)
-        wordScore += 7 * displayMatch;
-      const tagMatch = Math.max(...tagsLower.map((t) => fuzzyMatchScore(word, t)), fuzzyMatchScore(word, tagsCombined));
-      if (tagMatch > 0)
-        wordScore += 5 * tagMatch;
-      const descMatch = fuzzyMatchScore(word, descriptionLower);
-      if (descMatch > 0)
-        wordScore += 2 * descMatch;
-      if (wordScore === 0) {
-        allWordsMatch = false;
-        break;
-      }
-      score += wordScore;
-    }
-    if (allWordsMatch && score > 0) {
-      scored.push({ skill, score });
-    }
-  }
-  scored.sort((a, b) => b.score - a.score);
-  return scored.map((s) => s.skill);
-}
 function getSkill(name) {
   return loadRegistry().find((s) => s.name === name);
 }
@@ -1631,27 +1697,11 @@ function getSkillsByTag(tag) {
 function getAllTags() {
   const tagSet = new Set;
   for (const skill of loadRegistry()) {
-    for (const tag of skill.tags) {
+    for (const tag of skill.tags)
       tagSet.add(tag.toLowerCase());
-    }
   }
   return Array.from(tagSet).sort();
 }
-function levenshtein(a, b) {
-  const m = a.length, n = b.length;
-  const dp = Array.from({ length: m + 1 }, (_, i) => Array.from({ length: n + 1 }, (_2, j) => i === 0 ? j : j === 0 ? i : 0));
-  for (let i = 1;i <= m; i++) {
-    for (let j = 1;j <= n; j++) {
-      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
-    }
-  }
-  return dp[m][n];
-}
-function findSimilarSkills(query, maxResults = 3) {
-  const q = query.toLowerCase();
-  const scored = loadRegistry().map((s) => ({ name: s.name, dist: levenshtein(q, s.name.toLowerCase()) })).filter((s) => s.dist <= Math.max(3, Math.floor(q.length / 2))).sort((a, b) => a.dist - b.dist);
-  return scored.slice(0, maxResults).map((s) => s.name);
-}
 // src/lib/installer.ts
 import { existsSync as existsSync2, cpSync, mkdirSync, writeFileSync, rmSync, readdirSync as readdirSync2, statSync, readFileSync as readFileSync2, accessSync, constants } from "fs";
 import { join as join2, dirname } from "path";
@@ -2223,7 +2273,7 @@ import { existsSync as existsSync4, readFileSync as readFileSync4, writeFileSync
 import { join as join4, dirname as dirname2 } from "path";
 import { homedir as homedir3 } from "os";
 var VALID_KEYS = {
-  defaultAgent: ["claude", "codex", "gemini", "all"],
+  defaultAgent: ["claude", "codex", "gemini", "pi", "opencode", "all"],
   defaultScope: ["global", "project"],
   format: ["compact", "json", "csv"]
 };
@@ -2322,11 +2372,61 @@ function saveSchedules(data, targetDir = process.cwd()) {
     mkdirSync3(dir, { recursive: true });
   writeFileSync3(path, JSON.stringify(data, null, 2));
 }
+function validateCronField(expr, min, max, label) {
+  for (const part of expr.split(",")) {
+    if (part === "*")
+      continue;
+    let valuePart = part;
+    if (part.includes("/")) {
+      const slashIdx = part.indexOf("/");
+      valuePart = part.slice(0, slashIdx);
+      const stepStr = part.slice(slashIdx + 1);
+      const step = parseInt(stepStr);
+      if (isNaN(step) || step < 1)
+        return { valid: false, error: `Invalid step value in "${part}" in ${label}` };
+    }
+    if (valuePart === "*")
+      continue;
+    if (valuePart.includes("-")) {
+      const rangeParts = valuePart.split("-");
+      if (rangeParts.length !== 2)
+        return { valid: false, error: `Invalid range expression "${valuePart}" in ${label}` };
+      const lo = parseInt(rangeParts[0]);
+      const hi = parseInt(rangeParts[1]);
+      if (isNaN(lo) || isNaN(hi))
+        return { valid: false, error: `Invalid range "${valuePart}" in ${label}` };
+      if (lo < min || hi > max || lo > hi) {
+        return { valid: false, error: `Range ${lo}-${hi} outside valid ${min}-${max} in ${label}` };
+      }
+      continue;
+    }
+    const n = parseInt(valuePart);
+    if (isNaN(n))
+      return { valid: false, error: `Invalid value "${valuePart}" in ${label}` };
+    if (n < min || n > max) {
+      return { valid: false, error: `Value ${n} outside valid ${min}-${max} in ${label}` };
+    }
+  }
+  return { valid: true };
+}
 function validateCron(expr) {
   const fields = expr.trim().split(/\s+/);
   if (fields.length !== 5) {
     return { valid: false, error: `Expected 5 fields, got ${fields.length}. Format: "minute hour day-of-month month day-of-week"` };
   }
+  const [minuteF, hourF, domF, monthF, dowF] = fields;
+  const checks = [
+    { expr: minuteF, min: 0, max: 59, label: "minute" },
+    { expr: hourF, min: 0, max: 23, label: "hour" },
+    { expr: domF, min: 1, max: 31, label: "day-of-month" },
+    { expr: monthF, min: 1, max: 12, label: "month" },
+    { expr: dowF, min: 0, max: 6, label: "day-of-week" }
+  ];
+  for (const { expr: f, min, max, label } of checks) {
+    const result = validateCronField(f, min, max, label);
+    if (!result.valid)
+      return result;
+  }
   return { valid: true };
 }
 function getNextRun(cron, from = new Date) {

package/dist/lib/config.d.ts

@@ -9,7 +9,7 @@
  * Values from the project config override global config.
  */
 export interface SkillsConfig {
-    defaultAgent?: "claude" | "codex" | "gemini" | "all";
+    defaultAgent?: "claude" | "codex" | "gemini" | "pi" | "opencode" | "all";
     defaultScope?: "global" | "project";
     format?: "compact" | "json" | "csv";
 }

package/dist/lib/registry.d.ts

@@ -26,17 +26,7 @@ export declare function loadRegistry(cwd?: string): SkillMeta[];
 /** Invalidate the registry cache (e.g. after installing a custom skill). */
 export declare function clearRegistryCache(): void;
 export declare function getSkillsByCategory(category: Category): SkillMeta[];
-export declare function searchSkills(query: string): SkillMeta[];
+export { searchSkills, findSimilarSkills } from "./search.js";
 export declare function getSkill(name: string): SkillMeta | undefined;
-/**
- * Return all skills whose tags include a partial case-insensitive match for `tag`.
- */
 export declare function getSkillsByTag(tag: string): SkillMeta[];
-/**
- * Return all unique tags across every skill, sorted alphabetically.
- */
 export declare function getAllTags(): string[];
-/**
- * Find skills with names similar to the given query (for "did you mean?" suggestions)
- */
-export declare function findSimilarSkills(query: string, maxResults?: number): string[];

package/dist/lib/scheduler.d.ts

@@ -19,7 +19,7 @@ export interface SkillSchedule {
     lastRunStatus?: "success" | "error";
     nextRun?: string;
 }
-/** Validate a 5-field cron expression (basic syntax check). */
+/** Validate a 5-field cron expression with range checking. */
 export declare function validateCron(expr: string): {
     valid: boolean;
     error?: string;

package/dist/lib/scheduler.test.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Scheduler tests — cron validation, getNextRun, and schedule CRUD
+ */
+export {};

package/dist/lib/search.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Skill search — fuzzy matching with edit-distance and prefix scoring
+ */
+import { type SkillMeta } from "./registry.js";
+/**
+ * Compute Levenshtein edit distance between two strings.
+ * Uses a 2-row DP approach — no external deps.
+ */
+export declare function editDistance(a: string, b: string): number;
+/**
+ * Search skills by name, description, and tags using fuzzy matching.
+ */
+export declare function searchSkills(query: string): SkillMeta[];
+/**
+ * Find skills with names similar to the given query (for "did you mean?" suggestions).
+ */
+export declare function findSimilarSkills(query: string, maxResults?: number): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {

package/skills/skill-commitpush/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: skill-commitpush
+description: Create logical commits from all staged and unstaged changes, then push directly to main. Groups related changes into separate commits with conventional commit messages. Use when you want to commit and push without creating a PR.
+user_invocable: true
+---
+
+# Commit & Push to Main
+
+Create logical, well-organized commits from the current working directory changes and push directly to `main`.
+
+## Workflow
+
+1. Analyze changes: run `git status` and `git diff --stat`.
+2. Group logically:
+   - feature code and its tests
+   - documentation changes
+   - config or dependency changes
+   - refactors separate from new behavior
+3. Skip temp or generated files:
+   - `.agents-data/`, `.tmp/`, uploaded blobs
+   - non-package-manager lockfiles
+   - `.claude/scheduled_tasks.lock`
+4. Stage and commit each logical group:
+   - use `git add <specific files>`
+   - write a conventional commit message (`feat:`, `fix:`, `docs:`, `test:`, `chore:`, `refactor:`)
+   - explain why in the body when needed
+5. Push to `origin main`
+6. Report the commits created with short hashes and messages
+
+## Commit message format
+
+```text
+type: concise description of the change
+
+Optional body explaining why the change was made,
+not what was changed.
+```
+
+Use a heredoc when the message needs a body:
+
+```bash
+git commit -m "$(cat <<'EOF'
+type: description
+
+Body if needed.
+EOF
+)"
+```
+
+## Rules
+
+- Never use `git add .` or `git add -A`
+- Never commit secrets, `.env` files, or credentials
+- Never amend existing commits unless the user explicitly asks
+- Never force-push
+- If there are no changes, say so and stop
+- Prefer fewer, well-scoped commits over many tiny ones

package/skills/skill-commitpush/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@hasnaxyz/skill-commitpush",
+  "version": "0.1.0",
+  "description": "Instruction-set skill for logical commits and direct pushes to main",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "skill-commitpush": "src/index.ts"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "keywords": [
+    "git",
+    "commit",
+    "push",
+    "automation",
+    "skill"
+  ],
+  "license": "Apache-2.0",
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  }
+}

package/skills/skill-commitpush/src/index.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+const VERSION = "0.1.0";
+
+function printHelp(): void {
+  console.log(`skill-commitpush - Instruction-set skill
+
+DESCRIPTION:
+  Guides an agent through:
+    - scanning repo changes
+    - grouping them into logical commits
+    - writing conventional commit messages
+    - pushing directly to origin/main
+
+USAGE:
+  skills docs commitpush
+  skills install commitpush --for claude
+`);
+}
+
+const args = process.argv.slice(2);
+
+if (args.includes("--version") || args.includes("-v")) {
+  console.log(VERSION);
+  process.exit(0);
+}
+
+if (args.includes("--help") || args.includes("-h") || args.length === 0) {
+  printHelp();
+  process.exit(0);
+}
+
+console.log("This is an instruction-set skill. Install it for an agent with:");
+console.log("  skills install commitpush --for claude");

package/skills/skill-commitpush/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": "../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "ESNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "resolveJsonModule": true,
+    "noEmit": true
+  },
+  "include": [
+    "src/**/*"
+  ],
+  "exclude": [
+    "node_modules",
+    "dist"
+  ]
+}

package/skills/skill-commitpushpr/SKILL.md

@@ -0,0 +1,55 @@
+---
+name: skill-commitpushpr
+description: Create logical commits from all changes, push to a new branch, and open a pull request on GitHub. Groups related changes into separate commits with conventional commit messages. Use when you want to submit changes for review via PR instead of pushing directly to main.
+user_invocable: true
+---
+
+# Commit, Push & Create PR
+
+Create logical, well-organized commits from the current working directory changes, push to a feature branch, and open a pull request.
+
+## Workflow
+
+1. Analyze changes with `git status` and `git diff --stat`.
+2. Determine a descriptive branch name:
+   - `type/short-description`
+   - if already on a non-main branch, use it
+3. Create and switch to that branch if you are on `main`
+4. Group related changes into logical commits
+5. Skip temp or generated files:
+   - `.agents-data/`, `.tmp/`, uploaded blobs
+   - non-package-manager lockfiles
+   - `.claude/scheduled_tasks.lock`
+6. Stage specific files and commit with conventional messages
+7. Push with `git push -u origin <branch-name>`
+8. Create a PR with `gh pr create`
+9. Report the commits created and the PR URL
+
+## Commit message format
+
+```text
+type: concise description of the change
+
+Optional body explaining why the change was made,
+not what was changed.
+```
+
+## PR body format
+
+```markdown
+## Summary
+- bullet points
+
+## Test plan
+- [ ] checklist items
+```
+
+## Rules
+
+- Never use `git add .` or `git add -A`
+- Never commit secrets, `.env` files, or credentials
+- Never amend existing commits unless the user explicitly asks
+- Never force-push
+- Never push directly to `main`
+- If there are no changes, say so and stop
+- If already on a feature branch, reuse it

package/skills/skill-commitpushpr/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@hasnaxyz/skill-commitpushpr",
+  "version": "0.1.0",
+  "description": "Instruction-set skill for logical commits, feature-branch pushes, and pull requests",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "skill-commitpushpr": "src/index.ts"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "keywords": [
+    "git",
+    "commit",
+    "pull-request",
+    "github",
+    "skill"
+  ],
+  "license": "Apache-2.0",
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  }
+}