@hasna/skills 0.1.45 → 0.1.47
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +32 -1
- package/bin/index.js +469 -151
- package/bin/mcp.js +299 -68
- package/dist/index.js +108 -31
- package/dist/lib/compact-output.d.ts +32 -0
- package/dist/lib/skill-aliases.d.ts +1 -0
- package/package.json +2 -2
- package/skills/transcript/SKILL.md +53 -73
- package/skills/transcript/package.json +1 -1
- package/skills/apidocs/.claude/settings.json +0 -5
- package/skills/hook/bunfig.toml +0 -5
- package/skills/implementation/bunfig.toml +0 -5
package/README.md
CHANGED
|
@@ -125,12 +125,35 @@ requirements explicitly document local provider use.
|
|
|
125
125
|
|
|
126
126
|
- `--json` — Output as JSON (pipeable)
|
|
127
127
|
- `--brief` — One-line format
|
|
128
|
+
- `--limit <n>` — Cap human rows where supported; use `--limit all` or `--limit 0` for every row
|
|
129
|
+
- `--cursor <n>` — Continue human-output pagination from a numeric offset
|
|
128
130
|
- `--remote` — Read browse/search data from `SKILLS_API_URL` or `config apiUrl`
|
|
129
131
|
- `--dry-run` — Preview without applying changes
|
|
130
|
-
- `--verbose` — Debug logging
|
|
132
|
+
- `--verbose` — Debug logging globally; richer human discovery rows where supported
|
|
131
133
|
- `--no-color` — Disable ANSI colors
|
|
132
134
|
- `-o, --overwrite` — Refresh existing pin metadata
|
|
133
135
|
|
|
136
|
+
### Compact Output Defaults
|
|
137
|
+
|
|
138
|
+
Agent-facing discovery commands are compact by default. `skills list --all`,
|
|
139
|
+
`skills search <query> --all`, `skills tags`, `skills runs list`, and
|
|
140
|
+
`skills schedule list` cap human output and print a next-page command when more
|
|
141
|
+
rows are available.
|
|
142
|
+
|
|
143
|
+
Use explicit disclosure controls when you need more:
|
|
144
|
+
|
|
145
|
+
```bash
|
|
146
|
+
skills list --all --limit 50
|
|
147
|
+
skills list --all --cursor 50 --limit 50
|
|
148
|
+
skills list --all --limit all
|
|
149
|
+
skills list --all --verbose
|
|
150
|
+
skills show image
|
|
151
|
+
skills search pdf --json
|
|
152
|
+
```
|
|
153
|
+
|
|
154
|
+
CLI `--json` output remains the machine-readable full result for browse/search
|
|
155
|
+
commands. Human output is optimized for terminals and agent context.
|
|
156
|
+
|
|
134
157
|
### JSON Output Contracts
|
|
135
158
|
|
|
136
159
|
Commands that support `--json` write exactly one JSON value to stdout and keep
|
|
@@ -235,6 +258,14 @@ The MCP server exposes 20+ tools including `list_skills`, `search_skills`,
|
|
|
235
258
|
`run_skill`, `get_run_status`, `schedule_skill`, `detect_project_skills`,
|
|
236
259
|
`validate_skill`, and more.
|
|
237
260
|
|
|
261
|
+
MCP discovery and status tools use compact paged envelopes by default:
|
|
262
|
+
`list_skills` and `search_skills` return `skills` plus `total`, `offset`,
|
|
263
|
+
`limit`, and `nextOffset`; `list_schedules` returns the same metadata with a
|
|
264
|
+
`schedules` array. `run_skill` returns
|
|
265
|
+
stdout/stderr previews and compact run summaries unless the caller passes
|
|
266
|
+
`detail: true`. Use `get_skill_info`, `get_skill_docs`, or `detail: true` for
|
|
267
|
+
full records only when needed.
|
|
268
|
+
|
|
238
269
|
### Register with an Agent
|
|
239
270
|
|
|
240
271
|
```bash
|