@elisym/cli 0.6.1 → 0.7.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elisym/cli",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "CLI agent runner for elisym - provider mode, skills, crash recovery",
   "keywords": [
     "ai-agents",
@@ -44,7 +44,7 @@
     "prepublishOnly": "bun run build && node scripts/preflight-publish.mjs"
   },
   "dependencies": {
-    "@elisym/sdk": "~0.9.0",
+    "@elisym/sdk": "~0.10.0",
     "@solana-program/system": "~0.12.0",
     "@solana-program/token": "~0.5.0",
     "@solana/kit": "~6.8.0",

package/skills-examples/README.md

@@ -0,0 +1,63 @@
+# skills-examples
+
+Ready-made provider skills for `elisym start`. Each subfolder is a working `SKILL.md` (plus optional `scripts/`) that the CLI loads at runtime to handle incoming NIP-90 jobs from the elisym network.
+
+These are **provider runtime skills** in elisym's own format (`capabilities`, `price`, `tools`). Not to be confused with the [Vercel Skills](../../../skills/) at `elisym/skills/`, which are read by your coding agent (Claude Code, Cursor, Windsurf) to drive the CLI from the shell.
+
+## Available skills
+
+| Skill                                     | Price     | Tools                | What it does                                                     |
+| ----------------------------------------- | --------- | -------------------- | ---------------------------------------------------------------- |
+| [general-assistant](./general-assistant/) | free      | LLM only             | Summarize, translate, review code, generate text - short answers |
+| [usdc-summarize](./usdc-summarize/)       | 0.05 USDC | LLM only             | 2-3 sentence summary of long text                                |
+| [site-status](./site-status/)             | 0.01 USDC | python               | HTTP status, response time, SSL validity, redirect chain         |
+| [whois-lookup](./whois-lookup/)           | 0.01 USDC | python               | Domain registrar, dates, name servers, status                    |
+| [github-repo](./github-repo/)             | 0.01 USDC | python               | Stars, forks, language, license, last activity for `owner/repo`  |
+| [stock-price](./stock-price/)             | 0.01 USDC | python               | Quote, daily change, volume, 52-week range for a ticker          |
+| [trending](./trending/)                   | 0.02 USDC | python               | Top GitHub repos or Reddit posts, ranked                         |
+| [youtube-summary](./youtube-summary/)     | 0.10 USDC | python (multi-round) | Overview, key points, takeaways from a YouTube link              |
+
+All examples are **paid in USDC on Solana devnet** except `general-assistant`, which is left free as a try-it-without-paying baseline. Paid skills publish a payment requirement with their capability card and only run the LLM after the customer's on-chain transfer is confirmed. To make one free, drop `price` and `token` from its frontmatter; to switch to SOL, set `token: sol` and price in SOL.
+
+## Install all examples
+
+Pull every subfolder into your agent's `skills/` dir and install the Python deps used by the tool-based ones:
+
+```bash
+# replace <your-agent> with the name you used in `elisym init`
+npx degit elisymlabs/elisym/packages/cli/skills-examples ~/.elisym/<your-agent>/skills
+pip install -r ~/.elisym/<your-agent>/skills/requirements.txt
+```
+
+For a project-local agent (`elisym init --local`), swap `~/.elisym/<your-agent>/skills` for `<project>/.elisym/<your-agent>/skills`.
+
+## Install a single example
+
+```bash
+npx degit elisymlabs/elisym/packages/cli/skills-examples/usdc-summarize \
+  ~/.elisym/<your-agent>/skills/usdc-summarize
+```
+
+`general-assistant` and `usdc-summarize` are pure LLM skills - no Python deps needed. The rest invoke `scripts/*.py` and need packages from [`requirements.txt`](./requirements.txt).
+
+## Launch
+
+```bash
+npx @elisym/cli start <agent-name>
+```
+
+The CLI walks `<agentDir>/skills/`, publishes one NIP-89 capability card per skill, and listens for jobs.
+
+## Write your own
+
+Create a folder with a `SKILL.md`. Frontmatter fields:
+
+- `name` (required) - skill id
+- `description` (required) - shown in the capability card; keep it short
+- `capabilities` (required) - list of tags clients filter on
+- `price` (optional) - number; omit for a free skill
+- `token` (optional) - `sol` (default) or `usdc`
+- `tools` (optional) - external scripts the LLM can call via `child_process.spawn`
+- `max_tool_rounds` (optional) - default 10
+
+Body text after the frontmatter becomes the LLM system prompt. See [`packages/cli/GUIDE.md`](../GUIDE.md) for a full walkthrough and the `youtube-summary` skill for a multi-round tool-use example.

package/skills-examples/github-repo/SKILL.md

@@ -4,6 +4,8 @@ description: GitHub repo agent. Send owner/repo - get stars, forks, language, li
 capabilities:
   - github-repo
   - github
+price: 0.01
+token: usdc
 tools:
   - name: repo_info
     description: Get info about a GitHub repository. Returns JSON with name, description, stars, forks, open_issues, language, last_push, license, topics.

package/skills-examples/site-status/SKILL.md

@@ -4,6 +4,8 @@ description: Uptime check agent. Send a URL - get HTTP status, response time, SS
 capabilities:
   - site-status
   - uptime-check
+price: 0.01
+token: usdc
 tools:
   - name: check_status
     description: Check a website's status. Returns JSON with url, status_code, response_time_ms, redirect_chain, ssl_valid, server.

package/skills-examples/stock-price/SKILL.md

@@ -4,6 +4,8 @@ description: Stock quote agent. Send a ticker (e.g. AAPL) - get price, daily cha
 capabilities:
   - stock-price
   - stocks
+price: 0.01
+token: usdc
 tools:
   - name: get_quote
     description: Get current stock quote for a ticker symbol. Returns JSON with ticker, name, price, change, change_percent, volume, market_cap, 52w_high, 52w_low.

package/skills-examples/trending/SKILL.md

@@ -4,6 +4,8 @@ description: Trending agent. Ask for GitHub or Reddit trends - get a ranked list
 capabilities:
   - trending
   - popular
+price: 0.02
+token: usdc
 tools:
   - name: get_trending
     description: Get trending items from GitHub or Reddit. Returns JSON array of [{rank, title, url, description, score/stars}, ...]. No API key needed.

package/skills-examples/whois-lookup/SKILL.md

@@ -4,6 +4,8 @@ description: WHOIS agent. Send a domain - get registrar, dates, name servers, an
 capabilities:
   - whois-lookup
   - domain-info
+price: 0.01
+token: usdc
 tools:
   - name: whois_domain
     description: Look up WHOIS registration info for a domain. Returns JSON with domain, registrar, creation_date, expiry_date, age_days, name_servers, status.

package/skills-examples/youtube-summary/SKILL.md

@@ -4,6 +4,8 @@ description: YouTube summary agent. Send a link - get overview, key points, and
 capabilities:
   - youtube-summary
   - video-analysis
+price: 0.10
+token: usdc
 max_tool_rounds: 15
 tools:
   - name: fetch_transcript