Index of every page on this site: llms.txt
All skills
mvanhorn avatar

/printing-press

@9e1a8d4
Run it yourself

Set up a new integration, connector, or CLI binding for any API. Wrap or generate a ship-ready Go CLI from an OpenAPI, HAR, or Postman spec via the lean research -> generate -> build -> shipcheck loop. Use when the user says build a CLI, wrap this API, set up a new integration, add a connector, integrate with a service, or names an API by domain.

Use this Skill: https://skilld.dev/gh/mvanhorn/cli-printing-press/printing-press

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesws-primary-pattern.md

≈518 tokens on demand. Your agent reads this file only when SKILL.md points to it.

WebSocket-Primary Sync Pattern

Use this pattern when the target API's primary facts arrive over WebSocket and a REST endpoint supplies descriptive metadata needed for local queries.

Spec Shape

streaming:
  transport: websocket
  url: "wss://api.example.com/v1/ws"
  subscribe_shape: '{"type":"subscribe","channels":["events"]}'
  framing: newline_delimited_json
  metadata:
    endpoint: "/v1/events"
    refresh_cadence: 30s
    statuses: [live, pending]
    primary_key: event_id

framing may be single_object_per_frame or newline_delimited_json. When metadata.statuses is omitted, the generator polls both live and pending.

Emitted Surface

The generator emits:

  • live ws sync for WebSocket-primary ingest.
  • live rest sync as the REST polling fallback, reusing the generated sync command.
  • internal/wsclient with dial, subscribe, frame splitting, reconnect-with-backoff, and lifecycle event callbacks.
  • Local SQLite tables <api>_stream_frames, <api>_stream_metadata, and <api>_rebase_log.

The WebSocket scaffold stores raw JSON facts and raw metadata rows. Per-API novel code may add typed normalizers beside the generated files, but it should not reimplement the WebSocket lifecycle, metadata-status polling, or rebase-log mechanics.

Authoring Rules

  • Poll every configured metadata status. Default to both live and pending; polling only live misses rows that become live after the frame arrives.
  • Use newline_delimited_json whenever a vendor can send multiple JSON objects in one WebSocket message. The generated splitter feeds each line separately to json.Unmarshal.
  • Record reconnect, disconnect, subscribe, metadata, and parse events in <api>_rebase_log so operators can diagnose stream gaps.
  • Coordinate store writes through the generated live command's shared mutex. Per-API handlers that write additional dimension or fact tables should reuse that pattern.
  • Frame normalizers must use cliutil.ExtractNumber and cliutil.ExtractInt for numeric wire fields that may be JSON strings.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

2 warningstoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    The skill is a professional-grade development tool for generating Go-based CLIs from API specifications. It implements extensive security controls, including mandatory secret redaction, automated PII scrubbing, and dedicated code review phases that audit generated source code for security and correctness before execution.

  • Sockettoday

    3 alerts: gptAnomaly, gptSecurity

  • Snyktoday

    Risk: MEDIUM · 3 issues

Signed by skilld at 9e1a8d4. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 20 hours ago.

Activeupdated 2 weeks ago
What it can do
Runs commands Reads files Edits files Network
version
3.0.0
min-binary-version
4.35.4
created_by
user
All 10 allowed tools
BashReadWriteEditGlobGrepWebFetchWebSearchAskUserQuestionAgent

README badge

README badge for mvanhorn/cli-printing-press/printing-press