@devxiyang/agent-skill 0.0.1

package/skills/tmux/SKILL.md

@@ -0,0 +1,76 @@
+---
+name: tmux
+description: Remote-control tmux sessions for interactive CLIs by sending keystrokes and reading pane output. Use when a command requires an interactive TTY.
+requires: bin:tmux
+os: darwin,linux
+---
+
+# tmux Skill
+
+Use tmux only when you need an interactive TTY. For non-interactive long-running tasks, prefer background execution instead.
+
+## Quickstart
+
+```bash
+SOCKET=/tmp/agent-tmux.sock
+SESSION=agent
+
+tmux -S "$SOCKET" new -d -s "$SESSION" -n shell
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- 'python3 -q' Enter
+tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
+```
+
+After starting a session, always print monitor commands for the user:
+
+```
+To monitor:
+  tmux -S "$SOCKET" attach -t "$SESSION"
+  tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
+```
+
+## Socket convention
+
+Use a dedicated socket file per agent instance to avoid conflicts:
+
+```bash
+SOCKET="${AGENT_TMUX_SOCKET:-/tmp/agent-tmux.sock}"
+```
+
+## Sending input
+
+```bash
+# Literal send (safe for special chars)
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -l -- "$cmd"
+
+# With Enter
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 -- "$cmd" Enter
+
+# Control keys
+tmux -S "$SOCKET" send-keys -t "$SESSION":0.0 C-c
+```
+
+## Reading output
+
+```bash
+# Capture recent history
+tmux -S "$SOCKET" capture-pane -p -J -t "$SESSION":0.0 -S -200
+```
+
+## Session management
+
+```bash
+# List sessions
+tmux -S "$SOCKET" list-sessions
+
+# Kill session
+tmux -S "$SOCKET" kill-session -t "$SESSION"
+
+# Kill server (all sessions on socket)
+tmux -S "$SOCKET" kill-server
+```
+
+## Tips
+
+- Target format: `session:window.pane` (default `:0.0`)
+- Set `PYTHON_BASIC_REPL=1` for Python REPLs to avoid readline issues
+- Poll for shell prompt (`$` or `❯`) to detect command completion

package/skills/weather/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: weather
+description: Get current weather and forecasts for any location. No API key required.
+requires: bin:curl
+---
+
+# Weather Skill
+
+Two free services, no API keys needed.
+
+## wttr.in (primary)
+
+```bash
+# One-liner
+curl -s "wttr.in/London?format=3"
+# London: ⛅️ +8°C
+
+# Compact format
+curl -s "wttr.in/London?format=%l:+%c+%t+%h+%w"
+
+# Full 3-day forecast
+curl -s "wttr.in/London?T"
+```
+
+Format codes: `%c` condition · `%t` temp · `%h` humidity · `%w` wind · `%l` location
+
+Tips:
+- URL-encode spaces: `wttr.in/New+York`
+- Airport codes work: `wttr.in/JFK`
+- Units: `?m` metric · `?u` imperial
+- Today only: `?1` · Current only: `?0`
+
+## Open-Meteo (fallback, JSON, no key)
+
+```bash
+curl -s "https://api.open-meteo.com/v1/forecast?latitude=51.5&longitude=-0.12&current_weather=true"
+```
+
+Get coordinates first, then query. Returns JSON with temperature, windspeed, and weather code.

package/skills/web/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: web
+description: Fetch web pages, call REST APIs, download files, and extract content from URLs using curl.
+requires: bin:curl
+---
+
+# Web Skill
+
+## 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"}'
+
+# With auth header
+curl -s "https://api.example.com/data" \
+  -H "Authorization: Bearer $TOKEN"
+```
+
+## Download a file
+
+```bash
+curl -sL "https://example.com/file.zip" -o /tmp/file.zip
+```
+
+## Extract text from a page
+
+```bash
+# Strip HTML tags
+curl -sL "https://example.com" | sed 's/<[^>]*>//g' | sed '/^[[:space:]]*$/d'
+```
+
+## 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