@devxiyang/agent-skill 0.1.0 → 0.1.1

package/dist/builtin.d.ts

@@ -6,8 +6,6 @@
  * as a system-scoped root:
  *
  * ```ts
- * import { SkillDiscovery, builtinSkillsRoot } from '@devxiyang/agent-skill-core';
- *
  * new SkillDiscovery([
  *   { path: userSkillsDir, scope: 'user' },
  *   { path: builtinSkillsRoot(), scope: 'system' },
@@ -15,7 +13,7 @@
  * ```
  *
  * Note for Electron apps: if the app is packaged with asar, add
- * `node_modules/@devxiyang/agent-skill-core/skills` to `asarUnpack` in
+ * `node_modules/@devxiyang/agent-skill/skills` to `asarUnpack` in
  * electron-builder config so the directory is accessible via the filesystem.
  */
 export declare function builtinSkillsRoot(): string;

package/dist/builtin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../src/builtin.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}
+{"version":3,"file":"builtin.d.ts","sourceRoot":"","sources":["../src/builtin.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C"}

package/dist/builtin.js

@@ -8,8 +8,6 @@ import { fileURLToPath } from 'node:url';
  * as a system-scoped root:
  *
  * ```ts
- * import { SkillDiscovery, builtinSkillsRoot } from '@devxiyang/agent-skill-core';
- *
  * new SkillDiscovery([
  *   { path: userSkillsDir, scope: 'user' },
  *   { path: builtinSkillsRoot(), scope: 'system' },
@@ -17,7 +15,7 @@ import { fileURLToPath } from 'node:url';
  * ```
  *
  * Note for Electron apps: if the app is packaged with asar, add
- * `node_modules/@devxiyang/agent-skill-core/skills` to `asarUnpack` in
+ * `node_modules/@devxiyang/agent-skill/skills` to `asarUnpack` in
  * electron-builder config so the directory is accessible via the filesystem.
  */
 export function builtinSkillsRoot() {

package/dist/builtin.js.map

@@ -1 +1 @@
-{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../src/builtin.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"builtin.js","sourceRoot":"","sources":["../src/builtin.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACzD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devxiyang/agent-skill",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "SDK for skill discovery and registration — integrates into any agent",
   "license": "MIT",
   "repository": {

package/skills/node/SKILL.md

@@ -0,0 +1,173 @@
+---
+name: node
+description: Run Node.js scripts, manage packages with npm/npx, and use common built-in module patterns. Use for scripting, web tooling, automation, and general JavaScript/TypeScript development.
+requires: bin:node
+tags: node,javascript,typescript,scripting
+---
+
+# Node Skill
+
+## Preflight
+
+Verify Node.js is available before proceeding:
+
+```bash
+node --version
+npm --version
+```
+
+If missing, load `references/install.md` for installation instructions.
+
+## Running scripts
+
+```bash
+node script.js
+node script.js arg1 arg2
+node -e "console.log('hello')"
+
+# TypeScript (via tsx, no compile step)
+npx tsx script.ts
+```
+
+## Package management
+
+### npm
+
+```bash
+npm install
+npm install express
+npm install -D typescript
+npm uninstall lodash
+npm list --depth=0
+npm outdated
+npm update
+```
+
+### npx (run without installing)
+
+```bash
+npx tsx script.ts
+npx prettier --write .
+npx eslint src/
+```
+
+## Common built-in patterns
+
+### File I/O (fs/promises)
+
+```js
+import { readFile, writeFile, readdir } from 'node:fs/promises';
+import { join } from 'node:path';
+
+const text = await readFile('data.txt', 'utf8');
+await writeFile('out.txt', 'content');
+
+// Iterate files
+const files = await readdir('src');
+```
+
+### JSON
+
+```js
+// Parse
+const data = JSON.parse(text);
+
+// Serialize
+const json = JSON.stringify(data, null, 2);
+await writeFile('out.json', json);
+```
+
+### HTTP requests (built-in fetch)
+
+```js
+// Node 18+ has fetch built-in
+const res = await fetch('https://api.example.com/data');
+const data = await res.json();
+
+// POST JSON
+const res = await fetch('https://api.example.com/items', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({ name: 'foo' }),
+});
+```
+
+### Child process
+
+```js
+import { execSync, exec } from 'node:child_process';
+import { promisify } from 'node:util';
+
+// Sync
+const output = execSync('git status', { encoding: 'utf8' });
+
+// Async
+const execAsync = promisify(exec);
+const { stdout, stderr } = await execAsync('npm test');
+```
+
+### Argument parsing
+
+```js
+// Built-in (Node 18.3+)
+import { parseArgs } from 'node:util';
+
+const { values, positionals } = parseArgs({
+  args: process.argv.slice(2),
+  options: {
+    output: { type: 'string', short: 'o', default: 'out.txt' },
+    verbose: { type: 'boolean', short: 'v' },
+  },
+  allowPositionals: true,
+});
+```
+
+### Environment variables
+
+```js
+const token = process.env.API_TOKEN;
+if (!token) throw new Error('API_TOKEN is required');
+```
+
+## TypeScript
+
+Prefer `tsx` for running `.ts` files directly without a build step:
+
+```bash
+npx tsx script.ts
+
+# Or install globally
+npm install -g tsx
+tsx script.ts
+```
+
+For projects with `tsconfig.json`, check `compilerOptions.target` and `module` before running.
+
+## ESM vs CJS
+
+```js
+// ESM (package.json has "type": "module", or file is .mjs)
+import { readFile } from 'node:fs/promises';
+export function helper() {}
+
+// CJS (default, or file is .cjs)
+const { readFile } = require('fs').promises;
+module.exports = { helper };
+```
+
+Check `"type"` in `package.json` to know which mode applies.
+
+## Destructive Operations
+
+Always confirm with the user before running any of the following:
+
+| Command / Pattern | Risk |
+|-------------------|------|
+| `npm publish` | Publishes package to the public registry; cannot be fully unpublished |
+| `npm unpublish` | Removes a published package version (restricted after 72h) |
+| `fs.rm(path, { recursive: true })` / `fs.rmdir` recursive | Deletes directory tree permanently |
+| `fs.writeFile` / `fs.truncate` on existing files | Silently overwrites file content |
+| `execSync('rm -rf ...')` inside scripts | Shell deletion triggered from Node code |
+| `npx <unknown-package>` | Executes remote code; verify package name and source first |
+
+Before executing, state what files or registry resources will be affected, and ask for explicit confirmation.

package/skills/node/references/install.md

@@ -0,0 +1,63 @@
+# Installing Node.js
+
+## macOS
+
+Using nvm (recommended — manages multiple versions):
+
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+nvm install --lts
+nvm use --lts
+```
+
+If you have Homebrew:
+
+```bash
+brew install node
+```
+
+## Windows
+
+Download the installer from https://nodejs.org/en/download — pick the LTS release and run the `.msi` installer. Check "Add to PATH" during installation.
+
+If winget is available:
+
+```powershell
+winget install OpenJS.NodeJS.LTS
+```
+
+Or use nvm-windows:
+
+```powershell
+winget install CoreyButler.NVMforWindows
+nvm install lts
+nvm use lts
+```
+
+## Linux
+
+```bash
+# Debian/Ubuntu — via NodeSource
+curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
+sudo apt install nodejs
+
+# Fedora
+sudo dnf install nodejs
+
+# Arch
+sudo pacman -S nodejs npm
+```
+
+Using nvm (all platforms):
+
+```bash
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
+nvm install --lts
+```
+
+## Verify
+
+```bash
+node --version
+npm --version
+```

package/skills/python/SKILL.md

@@ -149,3 +149,17 @@ parser.add_argument("--output", "-o", default="out.txt")
 parser.add_argument("--verbose", "-v", action="store_true")
 args = parser.parse_args()
 ```
+
+## Destructive Operations
+
+Always confirm with the user before running any of the following:
+
+| Pattern | Risk |
+|---------|------|
+| `shutil.rmtree(path)` | Recursively deletes entire directory tree permanently |
+| `os.remove(path)` in a loop or with glob | Bulk file deletion, easy to match unintended files |
+| `open(path, 'w')` on an existing file | Silently overwrites and truncates file content |
+| `Path.write_text` / `Path.write_bytes` on existing file | Same as above |
+| `subprocess.run(['rm', '-rf', ...])` | Shell deletion triggered from Python code |
+
+Before executing, show the user the exact path or pattern that will be affected, and ask for explicit confirmation.

package/skills/shell/SKILL.md

@@ -1,7 +1,8 @@
 ---
 name: shell
-description: Write and run shell scripts. Use for automation, file operations, pipelines, and system tasks. Covers bash/zsh (macOS/Linux) and PowerShell (Windows).
-tags: shell,cli
+description: Write and run shell scripts, and make HTTP requests with curl. Use for automation, file operations, pipelines, system tasks, fetching web pages, and calling REST APIs. Covers bash/zsh (macOS/Linux) and PowerShell (Windows).
+requires: bin:curl
+tags: shell,cli,web,http
 ---
 
 # Shell Skill
@@ -216,3 +217,93 @@ Get-ChildItem -Recurse -Filter "*.tmp" | Remove-Item
 # Search in files
 Select-String -Path "src\*.ts" -Pattern "TODO"
 ```
+
+---
+
+## HTTP / curl
+
+Verify curl is available:
+
+```bash
+curl --version
+```
+
+If missing, load `references/install-curl.md`.
+
+### Fetch a web page
+
+```bash
+curl -sL "https://example.com"
+```
+
+### REST API calls
+
+```bash
+# GET
+curl -s "https://api.example.com/users" | jq .
+
+# POST JSON
+curl -s -X POST "https://api.example.com/items" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "foo"}'
+
+# PUT / DELETE
+curl -s -X PUT "https://api.example.com/items/1" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "bar"}'
+curl -s -X DELETE "https://api.example.com/items/1"
+
+# Auth header
+curl -s "https://api.example.com/data" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+### Form data & file upload
+
+```bash
+curl -s -X POST "https://example.com/login" \
+  -d "username=alice&password=secret"
+
+curl -s -X POST "https://example.com/upload" \
+  -F "file=@/path/to/file.pdf" \
+  -F "description=My file"
+```
+
+### Download a file
+
+```bash
+curl -sL "https://example.com/file.zip" -o /tmp/file.zip
+curl -C - -L "https://example.com/large.zip" -o /tmp/large.zip   # resume
+```
+
+### Inspect response
+
+```bash
+curl -sI "https://example.com"                            # headers only
+curl -sD - "https://example.com"                          # headers + body
+curl -s -o /dev/null -w "%{http_code}" "https://example.com"  # status code
+```
+
+### Tips
+
+- `-s` silences progress, `-L` follows redirects, `-v` debugs
+- `--max-time 10` sets timeout, `--compressed` enables gzip
+- `-sk` skips certificate check (testing only)
+
+---
+
+## Destructive Operations
+
+Always confirm with the user before running any of the following:
+
+| Command | Risk |
+|---------|------|
+| `rm -rf <path>` | Recursively deletes files/directories with no recovery |
+| `find ... -delete` / `find ... -exec rm` | Bulk file deletion, easy to match unintended paths |
+| `> file` (output redirect, not `>>`) | Silently overwrites and truncates existing file |
+| `truncate -s 0 file` | Empties file contents permanently |
+| `dd if=... of=...` | Overwrites device or file at block level |
+| `mkfs` / `fdisk` / `diskutil eraseDisk` | Formats and wipes entire disk partition |
+| `Get-ChildItem ... \| Remove-Item -Recurse` (PowerShell) | Recursive deletion |
+
+Before executing, show the user the exact path or glob that will be affected, and ask for explicit confirmation.

package/skills/vcs/SKILL.md

@@ -0,0 +1,207 @@
+---
+name: vcs
+description: Version control and GitHub collaboration — local git operations (branching, committing, merging, rebasing, history) and GitHub interactions via gh CLI (PRs, issues, releases, CI, code review).
+requires: bin:git
+tags: vcs,git,github
+---
+
+# VCS Skill
+
+## Preflight
+
+```bash
+git --version
+gh --version   # optional, needed for GitHub operations
+```
+
+If git is missing, load `references/install-git.md`.
+If gh is missing, load `references/install-gh.md`.
+
+---
+
+## Git — Common workflow
+
+```bash
+git status
+git diff
+git add <files>
+git commit -m "message"
+```
+
+## Branching
+
+```bash
+git checkout -b feature/name
+git switch main
+git branch -d feature/name
+```
+
+## Inspecting history
+
+```bash
+git log --oneline -20
+git log --oneline --graph --all
+git show <commit>
+git diff main...HEAD
+git blame <file>
+git blame -L 10,20 <file>
+```
+
+## Cherry-pick
+
+```bash
+git cherry-pick <commit>
+git cherry-pick <from>..<to>
+git cherry-pick -n <commit>   # stage only, no commit
+```
+
+## Tags
+
+```bash
+git tag -a v1.0.0 -m "Release 1.0.0"
+git tag
+git push origin --tags
+git tag -d v1.0.0
+git push origin :refs/tags/v1.0.0
+```
+
+## Undoing changes
+
+```bash
+git restore --staged <file>   # unstage
+git reset --soft HEAD~1       # undo last commit, keep changes staged
+git rebase -i HEAD~3          # edit recent commits interactively
+```
+
+## Stashing
+
+```bash
+git stash push -m "description"
+git stash list
+git stash pop
+```
+
+## Merging & rebasing
+
+```bash
+git merge feature/name
+git rebase main
+git rebase --abort
+git merge --abort
+```
+
+## Conflict resolution
+
+1. Open conflicting files, look for `<<<<<<<` markers
+2. Edit to desired state
+3. `git add <resolved-file>`
+4. `git rebase --continue` or `git merge --continue`
+
+## Worktrees
+
+```bash
+git worktree add ../project-fix fix/some-bug
+git worktree add -b feature/new ../project-feature main
+git worktree list
+git worktree remove ../project-fix
+```
+
+## Bisect
+
+```bash
+git bisect start
+git bisect bad
+git bisect good <commit>
+# mark each checkout as good/bad until found
+git bisect reset
+```
+
+## Remotes
+
+```bash
+git remote -v
+git fetch origin
+git pull --rebase
+git push -u origin HEAD
+```
+
+---
+
+## GitHub (gh CLI)
+
+Always specify `--repo owner/repo` when not inside a git directory.
+
+## Pull Requests
+
+```bash
+gh pr list --repo owner/repo
+gh pr view <number> --repo owner/repo
+gh pr checks <number> --repo owner/repo
+gh run view <run-id> --repo owner/repo --log-failed
+gh pr merge <number> --repo owner/repo --squash
+```
+
+## Code review
+
+```bash
+gh pr review <number> --approve --repo owner/repo
+gh pr review <number> --request-changes --body "Please fix X" --repo owner/repo
+gh pr review <number> --comment --body "Looks good overall" --repo owner/repo
+
+# Inline comment via API
+gh api repos/owner/repo/pulls/<number>/comments \
+  --method POST \
+  --field body="Comment text" \
+  --field commit_id="<sha>" \
+  --field path="src/file.ts" \
+  --field line=42
+```
+
+## Issues
+
+```bash
+gh issue list --repo owner/repo --state open
+gh issue view <number> --repo owner/repo
+gh issue create --title "Title" --body "Body" --repo owner/repo
+gh issue comment <number> --body "Comment" --repo owner/repo
+gh issue close <number> --repo owner/repo
+gh issue reopen <number> --repo owner/repo
+```
+
+## Releases
+
+```bash
+gh release list --repo owner/repo
+gh release create v1.0.0 --repo owner/repo --title "v1.0.0" --notes "Release notes"
+gh release upload v1.0.0 dist/app.zip --repo owner/repo
+```
+
+## API & JSON output
+
+```bash
+gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
+gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
+gh pr list --repo owner/repo --json number,title,author --jq '.[] | "\(.number): \(.title) by \(.author.login)"'
+```
+
+---
+
+## Destructive Operations
+
+Always confirm with the user before running any of the following:
+
+| Command | Risk |
+|---------|------|
+| `git reset --hard` | Discards all uncommitted changes permanently |
+| `git push --force` / `git push -f` | Overwrites remote history, affects all collaborators |
+| `git branch -D <branch>` | Force-deletes branch regardless of merge status |
+| `git clean -f` / `git clean -fd` | Deletes untracked files/directories permanently |
+| `git rebase -i` on pushed commits | Rewrites shared history |
+| `git restore <file>` | Discards working tree changes for that file |
+| `gh pr merge` | Merges and closes PR; hard to revert cleanly |
+| `gh release delete` | Permanently deletes a release and its assets |
+| `gh issue delete` | Permanently deletes an issue |
+| `gh repo delete` | Permanently deletes the entire repository |
+| `gh api --method DELETE ...` | Any DELETE API call is irreversible |
+
+Before executing, tell the user exactly what will be lost and ask for explicit confirmation.

package/skills/git/SKILL.md

@@ -1,166 +0,0 @@
----
-name: git
-description: Local git operations — branching, committing, merging, rebasing, history inspection, and conflict resolution.
-requires: bin:git
-tags: vcs,git
----
-
-# Git Skill
-
-## Preflight
-
-Verify git is available before proceeding:
-
-```bash
-git --version
-```
-
-If missing, load `references/install.md` for installation instructions.
-
-## Common workflow
-
-```bash
-git status
-git diff
-git add <files>
-git commit -m "message"
-```
-
-## Branching
-
-```bash
-git checkout -b feature/name
-git switch main
-git branch -d feature/name
-```
-
-## Inspecting history
-
-```bash
-git log --oneline -20
-git log --oneline --graph --all
-git show <commit>
-git diff main...HEAD
-git blame <file>
-```
-
-## Cherry-pick
-
-```bash
-# Apply a specific commit onto the current branch
-git cherry-pick <commit>
-
-# Cherry-pick a range
-git cherry-pick <from>..<to>
-
-# Cherry-pick without committing (stage only)
-git cherry-pick -n <commit>
-```
-
-## Tags
-
-```bash
-# Create annotated tag
-git tag -a v1.0.0 -m "Release 1.0.0"
-
-# List tags
-git tag
-
-# Push tags to remote
-git push origin --tags
-
-# Delete a tag
-git tag -d v1.0.0
-git push origin :refs/tags/v1.0.0
-```
-
-## Undoing changes
-
-```bash
-# Unstage
-git restore --staged <file>
-
-# Discard working tree changes
-git restore <file>
-
-# Undo last commit (keep changes staged)
-git reset --soft HEAD~1
-
-# Interactive rebase to edit recent commits
-git rebase -i HEAD~3
-```
-
-## Stashing
-
-```bash
-git stash push -m "description"
-git stash list
-git stash pop
-```
-
-## Merging & rebasing
-
-```bash
-# Merge
-git merge feature/name
-
-# Rebase onto main
-git rebase main
-
-# Abort on conflict
-git rebase --abort
-git merge --abort
-```
-
-## Conflict resolution
-
-1. Open conflicting files, look for `<<<<<<<` markers
-2. Edit to desired state
-3. `git add <resolved-file>`
-4. `git rebase --continue` or `git merge --continue`
-
-## Worktrees
-
-Check out multiple branches simultaneously in separate directories — useful for working on or reviewing a branch without touching the current working tree:
-
-```bash
-# Add a worktree for an existing branch
-git worktree add ../project-fix fix/some-bug
-
-# Add a worktree and create a new branch
-git worktree add -b feature/new ../project-feature main
-
-# List worktrees
-git worktree list
-
-# Remove a worktree when done
-git worktree remove ../project-fix
-```
-
-Each worktree shares the same repository history but has its own working directory and HEAD.
-
-## Debugging
-
-```bash
-# Find which commit introduced a bug (binary search)
-git bisect start
-git bisect bad                # current commit is broken
-git bisect good <commit>      # last known good commit
-# git will check out commits for you to test; mark each:
-git bisect good
-git bisect bad
-git bisect reset              # done
-
-# Show who last changed each line
-git blame <file>
-git blame -L 10,20 <file>    # specific line range
-```
-
-## Remotes
-
-```bash
-git remote -v
-git fetch origin
-git pull --rebase
-git push -u origin HEAD
-```

package/skills/github/SKILL.md

@@ -1,112 +0,0 @@
----
-name: github
-description: Interact with GitHub using the `gh` CLI. Use for issues, pull requests, CI runs, code review, and GitHub API queries.
-requires: bin:gh
-tags: vcs,github
----
-
-# GitHub Skill
-
-## Preflight
-
-Verify gh is available before proceeding:
-
-```bash
-gh --version
-```
-
-If missing, load `references/install.md` for installation and authentication instructions.
-
-Use the `gh` CLI to interact with GitHub. Always specify `--repo owner/repo` when not inside a git directory.
-
-## Pull Requests
-
-```bash
-# List open PRs
-gh pr list --repo owner/repo
-
-# View a PR
-gh pr view <number> --repo owner/repo
-
-# Check CI status
-gh pr checks <number> --repo owner/repo
-
-# View failed CI logs
-gh run view <run-id> --repo owner/repo --log-failed
-
-# Merge a PR
-gh pr merge <number> --repo owner/repo --squash
-gh pr merge <number> --repo owner/repo --merge
-gh pr merge <number> --repo owner/repo --rebase
-```
-
-## Code review
-
-```bash
-# Approve
-gh pr review <number> --approve --repo owner/repo
-
-# Request changes
-gh pr review <number> --request-changes --body "Please fix X" --repo owner/repo
-
-# Leave a comment
-gh pr review <number> --comment --body "Looks good overall" --repo owner/repo
-
-# Add inline comment via API
-gh api repos/owner/repo/pulls/<number>/comments \
-  --method POST \
-  --field body="Comment text" \
-  --field commit_id="<sha>" \
-  --field path="src/file.ts" \
-  --field line=42
-```
-
-## Issues
-
-```bash
-# List issues
-gh issue list --repo owner/repo --state open
-
-# View an issue
-gh issue view <number> --repo owner/repo
-
-# Create issue
-gh issue create --title "Title" --body "Body" --repo owner/repo
-
-# Comment on an issue
-gh issue comment <number> --body "Comment" --repo owner/repo
-
-# Close / reopen
-gh issue close <number> --repo owner/repo
-gh issue reopen <number> --repo owner/repo
-```
-
-## Releases
-
-```bash
-# List releases
-gh release list --repo owner/repo
-
-# Create a release
-gh release create v1.0.0 --repo owner/repo --title "v1.0.0" --notes "Release notes"
-
-# Upload assets to a release
-gh release upload v1.0.0 dist/app.zip --repo owner/repo
-```
-
-## API
-
-Use `gh api` for data not available via subcommands:
-
-```bash
-gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
-```
-
-## JSON Output
-
-Most commands support `--json` + `--jq`:
-
-```bash
-gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
-gh pr list --repo owner/repo --json number,title,author --jq '.[] | "\(.number): \(.title) by \(.author.login)"'
-```

package/skills/web/SKILL.md

@@ -1,139 +0,0 @@
----
-name: web
-description: Fetch web pages, call REST APIs, download files, and extract content from URLs using curl.
-requires: bin:curl
-tags: web,http
----
-
-# Web Skill
-
-## Preflight
-
-Verify curl is available before proceeding:
-
-```bash
-curl --version
-```
-
-If missing, load `references/install.md` for installation instructions.
-
-## Fetch a web page
-
-```bash
-curl -sL "https://example.com"
-```
-
-## REST API calls
-
-```bash
-# GET with JSON response
-curl -s "https://api.example.com/users" | jq .
-
-# POST JSON
-curl -s -X POST "https://api.example.com/items" \
-  -H "Content-Type: application/json" \
-  -d '{"name": "foo"}'
-
-# PUT
-curl -s -X PUT "https://api.example.com/items/1" \
-  -H "Content-Type: application/json" \
-  -d '{"name": "bar"}'
-
-# DELETE
-curl -s -X DELETE "https://api.example.com/items/1"
-
-# With auth header
-curl -s "https://api.example.com/data" \
-  -H "Authorization: Bearer $TOKEN"
-```
-
-## Form data & file upload
-
-```bash
-# Submit a form (application/x-www-form-urlencoded)
-curl -s -X POST "https://example.com/login" \
-  -d "username=alice&password=secret"
-
-# Multipart file upload
-curl -s -X POST "https://example.com/upload" \
-  -F "file=@/path/to/file.pdf" \
-  -F "description=My file"
-```
-
-## Cookies & sessions
-
-```bash
-# Save cookies to a file
-curl -s -c cookies.txt "https://example.com/login" \
-  -d "user=alice&pass=secret"
-
-# Reuse saved cookies
-curl -s -b cookies.txt "https://example.com/dashboard"
-```
-
-## Download a file
-
-```bash
-curl -sL "https://example.com/file.zip" -o /tmp/file.zip
-
-# Resume interrupted download
-curl -C - -L "https://example.com/large.zip" -o /tmp/large.zip
-```
-
-## Extract content from a page
-
-Prefer Python for reliable HTML parsing over fragile sed/grep:
-
-```bash
-curl -sL "https://example.com" | python3 -c "
-import sys, html.parser
-
-class TextExtractor(html.parser.HTMLParser):
-    skip = {'script', 'style'}
-    def __init__(self):
-        super().__init__()
-        self._tag = None
-        self.parts = []
-    def handle_starttag(self, tag, attrs):
-        self._tag = tag
-    def handle_data(self, data):
-        if self._tag not in self.skip and data.strip():
-            self.parts.append(data.strip())
-
-p = TextExtractor()
-p.feed(sys.stdin.read())
-print('\n'.join(p.parts))
-"
-```
-
-## Inspect response
-
-```bash
-# Headers only
-curl -sI "https://example.com"
-
-# Show both headers and body
-curl -sD - "https://example.com"
-
-# Show HTTP status code only
-curl -s -o /dev/null -w "%{http_code}" "https://example.com"
-```
-
-## HTTPS & certificates
-
-```bash
-# Skip certificate verification (use only for testing)
-curl -sk "https://self-signed.example.com"
-
-# Use a specific CA certificate
-curl -s --cacert /path/to/ca.crt "https://example.com"
-```
-
-## Tips
-
-- `-s` silences progress output
-- `-L` follows redirects
-- `-I` fetches headers only
-- `--max-time 10` sets a timeout in seconds
-- `--compressed` requests gzip encoding automatically
-- `-v` shows full request/response for debugging