Clipsmith capture

Skill OctopusGarage/clipsmith/skills/clipsmith-capture

Capture a URL or local media input into a portable Clipsmith bundle. Routes to platform-specific Clipsmith skills and validates the resulting bundle.From its SKILL.md

Install

npx -y skills add OctopusGarage/clipsmith --skill clipsmith-capture

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.9 KB, 446 tokens by cl100k_base, as published. Nobody here has run it

Clipsmith Capture

Use this skill when the user wants to download, save, capture, archive, or OCR a post, article, or local media item into a Clipsmith bundle.

Flow

Start a job:

clipsmith capture start "<input>" --state-dir "<state_dir>"

Read the returned provider, job_id, and job_path.
Use the matching platform skill:
- clipsmith-xhs
- clipsmith-x
- clipsmith-wechat
- clipsmith-web
- clipsmith-ocr
The platform skill may first run a copied downloader that produces raw assets. Before returning, it must convert raw output into a bundle with the shared normalizer when the provider does not already produce a validated bundle:
```
uv run clipsmith normalize raw "<provider>" "<raw_dir>" "<bundle_dir>" \
  --source-url "<original_url>" \
  --json
```
The final bundle may contain only capture.json, post.md, summary.md, optional ocr.md/ocr.txt when OCR text was produced, plus separate OCR image files when preserving a source image for an image OCR capture.
- If OCR ran at any point, write the raw OCR transcript to ocr.md or ocr.txt and declare it in capture.json.content_files with kind: "ocr-text".
- Do not store OCR text only inside summary.md; the raw OCR file is part of the reviewable source material.

Validate and finalize:

clipsmith validate-bundle "<bundle_dir>" --json
clipsmith capture finalize "<job_id_or_job_path>" "<bundle_dir>" --state-dir "<state_dir>"

Report the bundle path, status, warnings, and validation issues.

Do not write knowledge records. Do not move the bundle into an external inbox workspace unless the user explicitly requested an inbox sink.

What ships with it: 2 files

1.2 KB alongside SKILL.md

agents/

openai.yaml593 B

quality-gate.json653 B