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.

referencesper-source-rate-limiting.md

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

Per-source rate limiting

Hand-written clients in sibling internal packages (internal/source/<name>/, internal/recipes/, internal/phgraphql/, etc.) MUST use cliutil.AdaptiveLimiter and surface *cliutil.RateLimitError from public methods when 429 retries are exhausted. Returning empty results on throttle is silent corruption: downstream queries cannot tell "the source has no data" from "the source rate-limited us."

Reference shape

import (
    "context"
    "errors"
    "net/http"

    "<modulePath>/internal/cliutil"
)

type Client struct {
    HTTP    *http.Client
    limiter *cliutil.AdaptiveLimiter
}

func New() *Client {
    return &Client{
        HTTP:    &http.Client{},
        limiter: cliutil.NewAdaptiveLimiter(2.0),
    }
}

func (c *Client) Fetch(ctx context.Context, url string) ([]byte, error) {
    if err := c.limiter.Wait(ctx); err != nil {
        return nil, err
    }
    req, err := http.NewRequestWithContext(ctx, "GET", url, nil)
    if err != nil {
        return nil, err
    }
    resp, err := c.HTTP.Do(req)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()
    if resp.StatusCode == http.StatusTooManyRequests {
        c.limiter.OnRateLimit()
        return nil, &cliutil.RateLimitError{
            URL:        url,
            RetryAfter: cliutil.RetryAfter(resp),
        }
    }
    c.limiter.OnSuccess()
    // ... read + return body ...
    return nil, nil
}

Higher-level fanout commands

Aggregations that fan out N filings/items MUST errors.As(err, &rateErr) and propagate the failure rather than continue-ing past it:

for _, item := range items {
    detail, err := c.FetchDetail(ctx, item.ID)
    if err != nil {
        var rateErr *cliutil.RateLimitError
        if errors.As(err, &rateErr) {
            return nil, err
        }
        continue // other errors are still skippable
    }
    out = append(out, detail)
}

Enforcement

cli-printing-press dogfood runs source_client_check, which scans every internal/<pkg>/*.go file outside the generator-emitted set. A file that makes outbound HTTP calls but lacks a limiter signal or a typed-error signal produces a finding.

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