Affonso - Affiliate Marketing Software

v1.0.0

Manage affiliate marketing programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program sett...

⭐ 0· 93·0 current·0 all-time

by@zilvestro

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for zilvestro/affonso.

Previewing Install & Setup.

Prompt PreviewInstall & Setup

Install the skill "Affonso - Affiliate Marketing Software" (zilvestro/affonso) from ClawHub.
Skill page: https://clawhub.ai/zilvestro/affonso
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required env vars: AFFONSO_API_KEY
Required binaries: affonso
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install affonso

ClawHub CLI

Package manager switcher

npx clawhub@latest install affonso

Security Scan

Capability signals

CryptoCan make purchasesRequires OAuth token

These labels describe what authority the skill may exercise. They are separate from suspicious or malicious moderation verdicts.

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

ℹ

Purpose & Capability

Name/description match the requested artifacts: the skill expects an 'affonso' CLI binary and an AFFONSO_API_KEY environment variable, which are appropriate for a CLI-based affiliate-management skill. Minor inconsistency: the SKILL.md header includes an install hint (npm package '@affonso/cli') while the registry metadata indicates 'no install spec' — this is a documentation/packaging mismatch but does not change capability alignment.

✓

Instruction Scope

SKILL.md instructs the agent to run only Affonso CLI commands (always with --json), to verify auth with 'affonso whoami', and to avoid browser-based login. The instructions do not ask the agent to read arbitrary files, other env vars, or transmit data to unknown endpoints. Command options do allow sending IPs, user-agent strings, and payment references (expected for this domain) but those are part of legitimate product functionality.

ℹ

Install Mechanism

This is instruction-only (no install spec in registry), so nothing will be written to disk by the skill itself. The SKILL.md metadata references installing '@affonso/cli' via node/npm — if a user chooses to install the CLI, that would be an external npm dependency. That install path is reasonable but the documentation mismatch should be clarified (no automated install provided by the skill).

✓

Credentials

Only AFFONSO_API_KEY is required, which is proportional and expected for an API-driven CLI. No other unrelated secrets or config paths are requested. Note: the CLI supports --api-key and --base-url overrides and the affonso config can store keys/URLs — users should be aware the CLI will use those values when invoked.

✓

Persistence & Privilege

The skill does not request 'always: true', has no elevated persistence or system-wide config changes, and does not claim to modify other skills. Autonomous invocation is allowed (platform default) but nothing in the skill increases privilege beyond normal CLI usage.

Assessment

This skill is an instruction-only adapter for the official Affonso CLI and appears coherent. Before installing or using it: (1) ensure you actually have the official 'affonso' binary or install the official '@affonso/cli' package from a trusted source (verify npm publisher and package contents); (2) provide an AFFONSO_API_KEY with least privilege needed (avoid using a full-owner key if possible); (3) be careful with destructive commands (payouts, delete) — the skill correctly warns to confirm deletes; (4) be aware the CLI may send data (including any IP or user-agent you pass) to the Affonso API or any base-url you configure; (5) clarify the doc mismatch about automated install if you expect the skill to install the CLI for you.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

Binsaffonso

EnvAFFONSO_API_KEY

latestvk9764rhtenq82dw3a63d7hk1xx84rr5g

93downloads

0stars

1versions

Updated 2w ago

v1.0.0

MIT-0

Affonso CLI Skill

Manage affiliate marketing programs from the command line.

Authentication

Use the AFFONSO_API_KEY environment variable. Verify with:

affonso whoami --json

Never use affonso login — it requires a browser and won't work in headless environments.

Rules

Always use --json on every command — without it, the CLI outputs ANSI tables that can't be parsed.
Never delete without user confirmation — all delete operations are destructive and irreversible.
Pagination — referrals use cursor-based pagination (--starting-after, --ending-before); all other resources use page-based (--page, --limit).

Commands

Command	Description
`affiliates`	List, get, create, update, delete affiliates
`referrals`	List, get, create, update, delete referrals (cursor-based pagination)
`commissions`	List, get, create, update, delete commissions
`payouts`	List, get, update payouts (no create/delete)
`coupons`	List, get, create, delete coupons (no update)
`clicks`	Create click events with UTM and sub-tracking
`embed-tokens`	Create embed tokens for partner portals
`program`	Get/update program settings + 8 sub-resources
`marketplace`	Browse/search public programs (no auth required)
`config`	Get/set CLI config (api-key, base-url)
`whoami`	Show authentication status

For full command details and options, see references/COMMAND_REFERENCE.md. For program sub-resources (payment-terms, tracking, restrictions, fraud-rules, portal, notifications, groups, creatives), see references/PROGRAM_SETTINGS_GUIDE.md.