Skip to content

docs(skills): document attribution handoff contract #74

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
replynodes-ai merged 1 commit into from
Oct 10, 2026
Merged

docs(skills): document attribution handoff contract #74

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions skills/brand-kit/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -67,6 +67,16 @@ root returns a small usage document (not the data endpoint). Append `.json` for
the machine-readable readback; the human-facing route may render an HTML brand
page.

## Producer/host boundary and attribution handoff

A host without an explicit header-capable integration must omit attribution
rather than infer it. For the existing Brand host request only, the exact
eligible read-only/public `GET`/`HEAD` handoff is exactly one header value,
`X-ReplyNodes-Skill: brand-kit`, with a maximum of 64 bytes. Handling is
fail-closed: malformed, duplicate, unknown, case-mismatched, or oversized
values are unattributed. This handoff grants no credentials or write
capability.

The JSON response is the canonical Brand Intelligence retrieve object (for
example `identity`, `brand_kit`, `quality`, and `provenance`) plus an optional
merged `styleguide` object and a `meta` object:
Expand Down
9 changes: 9 additions & 0 deletions skills/brand-logo/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -50,6 +50,15 @@ When the caller needs structured JSON instead of image bytes, the canonical
curl --fail-with-body 'https://api.replynodes.com/v1/brand/logo?domain=replynodes.com'
```

## Producer/host boundary and attribution handoff

A host without an explicit header-capable integration must omit attribution
rather than infer it. For the existing public logo `GET`/`HEAD` surfaces
documented above only, the exact eligible read-only/public handoff is exactly one header value, `X-ReplyNodes-Skill: brand-logo`, with a maximum of 64 bytes.
Handling is fail-closed: malformed, duplicate, unknown, case-mismatched, or
oversized values are unattributed. This handoff grants no credentials or write
capability.

## Limits and errors

The `GET /v1/brand/logo` route is admitted through the shared anonymous quota at
Expand Down
10 changes: 10 additions & 0 deletions skills/url-to-markdown/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -61,6 +61,16 @@ required. Never ask the user for credentials for this workflow. Keep the exact
input URL alongside the returned Markdown; do not rewrite, shorten,
canonicalize, or replace the source URL.

## Producer/host boundary and attribution handoff

A host without an explicit header-capable integration must omit attribution
rather than infer it. For the existing Markdown host request only, the exact
eligible read-only/public `GET`/`HEAD` handoff is exactly one header value,
`X-ReplyNodes-Skill: url-to-markdown`, with a maximum of 64 bytes. Handling is
fail-closed: malformed, duplicate, unknown, case-mismatched, or oversized
values are unattributed. This handoff grants no credentials or write
capability.

A longer response can be saved:

```bash
Expand Down
Loading