← Back to Skills Marketplace
97
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install affonso
Description
Manage affiliate marketing programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program sett...
README (SKILL.md)
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
--jsonon 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.
Quick Start
- Verify auth:
affonso whoami --json - List resources:
affonso affiliates list --json --limit 5 - Take action: approve, create, update, or configure as needed
For multi-step workflow recipes, see references/WORKFLOWS.md.
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: affonso
Version: 1.0.0
The 'affonso' skill is a legitimate integration for managing affiliate marketing programs via the Affonso CLI. It provides comprehensive documentation for managing affiliates, referrals, commissions, and program settings, and it correctly identifies the need for an `AFFONSO_API_KEY`. The installation process uses a standard npm package (@affonso/cli), and the instructions in SKILL.md are well-aligned with the tool's purpose, including safety warnings about destructive operations.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install affonso - After installation, invoke the skill by name or use
/affonso - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Manage affiliate, referral, influencer, and partner programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program settings. Use when the user asks about affiliate management, referral tracking, partner programs, influencer campaigns, commission handling, or payout processing.
- Initial release of the Affonso skill (version 1.0.0).
- Enables management of affiliate marketing programs via the Affonso CLI: create affiliates, track referrals, handle commissions, process payouts, and configure program settings.
- Always outputs machine-readable JSON; never use affonso login (requires browser).
- Incorporates rules for safe destructive actions (confirmation required for deletes) and correct use of pagination.
- Includes command overview covering affiliates, referrals, commissions, payouts, coupons, clicks, embed tokens, program settings, marketplace, config, and authentication.
- Provides links to in-depth command references and workflow guides.
Metadata
Frequently Asked Questions
What is Affonso - Affiliate Marketing Software?
Manage affiliate marketing programs via the Affonso CLI — create affiliates, track referrals, handle commissions, process payouts, and configure program sett... It is an AI Agent Skill for Claude Code / OpenClaw, with 97 downloads so far.
How do I install Affonso - Affiliate Marketing Software?
Run "/install affonso" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Affonso - Affiliate Marketing Software free?
Yes, Affonso - Affiliate Marketing Software is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Affonso - Affiliate Marketing Software support?
Affonso - Affiliate Marketing Software is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Affonso - Affiliate Marketing Software?
It is built and maintained by zilvestro (@zilvestro); the current version is v1.0.0.
More Skills