@hasna/skills 0.1.18 → 0.1.20

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"
+  }
+}

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

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+const VERSION = "0.1.0";
+
+function printHelp(): void {
+  console.log(`skill-commitpushpr - Instruction-set skill
+
+DESCRIPTION:
+  Guides an agent through:
+    - scanning repo changes
+    - grouping them into logical commits
+    - pushing to a feature branch
+    - creating a pull request with gh
+
+USAGE:
+  skills docs commitpushpr
+  skills install commitpushpr --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 commitpushpr --for claude");

package/skills/skill-commitpushpr/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-monitor/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: skill-monitor
+description: Interact with the open-monitor MCP — check machine health, list processes, kill memory hogs, run doctor, manage cron jobs, trigger cache cleanup
+user_invocable: true
+---
+
+# skill-monitor
+
+Use the `monitor_*` MCP tools from `@hasna/monitor` to help the user manage their machines.
+
+## Prerequisites check
+
+If any `monitor_*` tool call fails with "tool not found" or "MCP not connected", tell the user:
+
+```text
+The open-monitor MCP is not installed. Add it with:
+  claude mcp add monitor -- monitor-mcp
+Then restart Claude Code and try again.
+```
+
+## Use cases
+
+### Check machine health
+**Trigger**: "how is the machine doing?", "machine health", "system status", "is everything ok?"
+
+1. Call `monitor_health` (no args, or `machine_id: "local"`)
+2. Call `monitor_snapshot` to get current CPU/memory/disk
+3. Summarize: overall status, any alerts, top resource users
+
+### List memory hogs
+**Trigger**: "what's eating memory?", "high memory processes", "memory usage", "what's using RAM?"
+
+1. Call `monitor_processes`
+2. Show a table: PID, name, memory (MB), CPU%
+3. Offer to kill any if the user wants
+
+### Kill a process
+**Trigger**: "kill pid 1234", "kill process X", "stop process Y"
+
+1. Confirm the process name/PID with the user if ambiguous
+2. Call `monitor_kill` with `pid: <pid>` and `signal: "SIGTERM"`
+3. Report the result; if it failed, offer `SIGKILL`
+
+### Run doctor
+**Trigger**: "run doctor", "doctor check", "health check", "diagnose"
+
+1. Call `monitor_doctor` (optionally with `machine_id`)
+2. Show the full report: status per check, recommended actions
+3. If any checks failed, summarize what to fix
+
+### Trigger cache cleanup
+**Trigger**: "clean caches", "clear dev caches", "free up disk", "cleanup npm/bun/pip cache"
+
+1. Find the `cache-cleaner` cron job: call `monitor_cron_jobs` with `action: "list"`
+2. Run it with `monitor_cron_jobs`
+3. Report what changed
+
+### List cron jobs
+**Trigger**: "show monitor jobs", "what cron jobs are set up?", "monitor schedule"
+
+1. Call `monitor_cron_jobs` with `action: "list"`
+2. Show a table: name, schedule, action type, enabled, last run
+3. Offer to enable/disable or run any job
+
+## Output style
+
+- Use tables for process lists and cron job lists
+- Lead with the summary and keep details below it
+- Always show the machine ID being queried (default: local)

package/skills/skill-monitor/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@hasnaxyz/skill-monitor",
+  "version": "0.1.0",
+  "description": "Instruction-set skill for operating the open-monitor MCP",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "skill-monitor": "src/index.ts"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "keywords": [
+    "monitor",
+    "mcp",
+    "machine",
+    "ops",
+    "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-monitor/src/index.ts

@@ -0,0 +1,34 @@
+#!/usr/bin/env bun
+
+const VERSION = "0.1.0";
+
+function printHelp(): void {
+  console.log(`skill-monitor - Instruction-set skill
+
+DESCRIPTION:
+  Guides an agent through common open-monitor MCP workflows:
+    - machine health and doctor checks
+    - process inspection and safe termination
+    - cron job inspection and execution
+    - cache cleanup and operational summaries
+
+USAGE:
+  skills docs monitor
+  skills install monitor --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 monitor --for claude");

package/skills/skill-monitor/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-read-csv/SKILL.md

@@ -0,0 +1,62 @@
+---
+name: skill-read-csv
+description: Parse CSV files into structured JSON with delimiter auto-detection, header handling, common encoding support, and streaming reads for large files.
+---
+
+# Read CSV
+
+Parse CSV files from disk and return structured JSON that is easy to inspect, transform, or hand to another tool.
+
+## Features
+
+- Delimiter auto-detection for comma, tab, semicolon, and pipe
+- Header detection with `auto`, `true`, and `false` modes
+- Common encoding support (`utf8`, `utf16le`, `utf16be`, `latin1`, `win1252`)
+- Streaming parser for large files
+- Optional row limits and file output
+
+## Usage
+
+```bash
+# Parse a CSV with auto-detected headers and delimiter
+skill-read-csv --input ./customers.csv
+
+# Force tab-delimited parsing and save output
+skill-read-csv --input ./report.tsv --delimiter tab --output ./report.json
+
+# Parse with explicit header handling
+skill-read-csv --input ./raw.csv --headers false
+
+# Preview the first 100 rows only
+skill-read-csv --input ./large.csv --limit 100
+```
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-i, --input <path>` | CSV file to parse | required |
+| `-d, --delimiter <value>` | Delimiter (`comma`, `tab`, `semicolon`, `pipe`, or literal character) | auto |
+| `-e, --encoding <value>` | Input encoding (`auto`, `utf8`, `utf16le`, `utf16be`, `latin1`, `win1252`) | auto |
+| `--headers <mode>` | Header mode: `auto`, `true`, `false` | auto |
+| `-l, --limit <n>` | Stop after parsing `n` rows | unlimited |
+| `-o, --output <path>` | Save JSON result to a file | stdout |
+| `--help` | Show usage | |
+| `--version` | Show version | |
+
+## Output Shape
+
+```json
+{
+  "input": "/absolute/path/to/file.csv",
+  "encoding": "utf8",
+  "delimiter": ",",
+  "hasHeader": true,
+  "columns": ["id", "email", "plan"],
+  "rowCount": 2,
+  "truncated": false,
+  "rows": [
+    { "id": "1", "email": "a@example.com", "plan": "pro" }
+  ]
+}
+```

package/skills/skill-read-csv/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@hasnaxyz/skill-read-csv",
+  "version": "0.1.0",
+  "description": "Parse CSV files into structured JSON with delimiter and encoding detection",
+  "type": "module",
+  "main": "src/index.ts",
+  "bin": {
+    "skill-read-csv": "src/index.ts"
+  },
+  "files": [
+    "src",
+    "SKILL.md",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "keywords": [
+    "csv",
+    "parser",
+    "data",
+    "cli",
+    "skill"
+  ],
+  "license": "Apache-2.0",
+  "scripts": {
+    "start": "bun run src/index.ts",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "csv-parse": "^5.5.6",
+    "iconv-lite": "^0.6.3"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.7.0"
+  }
+}