← Back to Skills Marketplace
aiwithabidi

Convertkit

by aiwithabidi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
411
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install convertkit
Description
ConvertKit (Kit) creator marketing — manage subscribers, forms, sequences, broadcasts, tags, and automations via the ConvertKit API. Build email lists, creat...
README (SKILL.md)

✉️ ConvertKit

ConvertKit (Kit) creator marketing — manage subscribers, forms, sequences, broadcasts, tags, and automations via the ConvertKit API.

Features

  • Subscriber management — add, tag, search, and segment
  • Form management — list forms and their subscribers
  • Email sequences — create and manage drip campaigns
  • Broadcasts — create and send one-time emails
  • Tag operations — create, apply, remove subscriber tags
  • Automation rules — view automation workflows
  • Custom fields — manage subscriber custom fields
  • Subscriber search — find by email or custom attributes
  • Analytics — subscriber growth, form conversions, sequence stats
  • Bulk operations — tag/untag multiple subscribers

Requirements

Variable Required Description
CONVERTKIT_API_KEY ✅ API key/token for ConvertKit

Quick Start

# List subscribers
python3 {baseDir}/scripts/convertkit.py subscribers --limit 50 --sort created_at

# Get subscriber details
python3 {baseDir}/scripts/convertkit.py subscriber-get 12345

# Add a subscriber
python3 {baseDir}/scripts/convertkit.py subscriber-add --email "[email protected]" --first-name "Jane"

# Search by email
python3 {baseDir}/scripts/convertkit.py subscriber-search "[email protected]"

Commands

subscribers

List subscribers.

python3 {baseDir}/scripts/convertkit.py subscribers --limit 50 --sort created_at

subscriber-get

Get subscriber details.

python3 {baseDir}/scripts/convertkit.py subscriber-get 12345

subscriber-add

Add a subscriber.

python3 {baseDir}/scripts/convertkit.py subscriber-add --email "[email protected]" --first-name "Jane"

subscriber-search

Search by email.

python3 {baseDir}/scripts/convertkit.py subscriber-search "[email protected]"

tags

List all tags.

python3 {baseDir}/scripts/convertkit.py tags

tag-create

Create a tag.

python3 {baseDir}/scripts/convertkit.py tag-create "VIP Customer"

tag-apply

Tag a subscriber.

python3 {baseDir}/scripts/convertkit.py tag-apply --tag 123 --email [email protected]

tag-remove

Remove tag.

python3 {baseDir}/scripts/convertkit.py tag-remove --tag 123 --email [email protected]

forms

List forms.

python3 {baseDir}/scripts/convertkit.py forms

form-subscribers

List form subscribers.

python3 {baseDir}/scripts/convertkit.py form-subscribers 456

sequences

List sequences.

python3 {baseDir}/scripts/convertkit.py sequences

sequence-subscribers

List sequence subscribers.

python3 {baseDir}/scripts/convertkit.py sequence-subscribers 789

broadcasts

List broadcasts.

python3 {baseDir}/scripts/convertkit.py broadcasts --limit 20

broadcast-create

Create a broadcast.

python3 {baseDir}/scripts/convertkit.py broadcast-create '{"subject":"Weekly Update","content":"\x3Cp>Hello!\x3C/p>"}'

broadcast-send

Send a broadcast.

python3 {baseDir}/scripts/convertkit.py broadcast-send 12345

Output Format

All commands output JSON by default. Add --human for readable formatted output.

# JSON (default, for programmatic use)
python3 {baseDir}/scripts/convertkit.py subscribers --limit 5

# Human-readable
python3 {baseDir}/scripts/convertkit.py subscribers --limit 5 --human

Script Reference

Script Description
{baseDir}/scripts/convertkit.py Main CLI — all ConvertKit operations

Data Policy

This skill never stores data locally. All requests go directly to the ConvertKit API and results are returned to stdout. Your data stays on ConvertKit servers.

Credits

Built by M. Abidi | agxntsix.ai YouTube | GitHub Part of the AgxntSix Skill Suite for OpenClaw agents.

📅 Need help setting up OpenClaw for your business? Book a free consultation

Usage Guidance
This skill appears to implement what it claims (ConvertKit API operations) and only needs your ConvertKit API key — however the bundled script will, if the env var is missing, attempt to read a .env file from a workspace path (defaults to ~/.openclaw/workspace/.env) and will honor an undeclared WORKSPACE env var. That means it may read files you didn't expect it to access. Before installing or running: (1) inspect scripts/convertkit.py yourself (or have someone you trust do so); (2) prefer providing CONVERTKIT_API_KEY explicitly in the agent's secret store rather than relying on a workspace .env file; (3) avoid running with a workspace that contains unrelated secrets, or remove/secure other secrets in the .env; (4) consider using a limited-scope API key (rotate it after testing); and (5) if you want the skill to be fully transparent, ask the publisher to document the .env fallback behavior in SKILL.md or remove that fallback. If the author documents or removes the .env/WORKSPACE behavior, this assessment could be upgraded to benign.
Capability Analysis
Type: OpenClaw Skill Name: convertkit Version: 1.0.0 The `scripts/convertkit.py` file exhibits an input sanitization vulnerability where `args.id` is directly interpolated into API paths (e.g., `/subscribers/{args.id}`) without validation. This could lead to unexpected API calls or errors if malicious input is provided. Additionally, the script contains a significant functional bug where many POST/PUT operations (e.g., `subscriber-add`, `broadcast-create`) fail to parse and send the required request body data, rendering core functionalities non-operational. While no clear malicious intent like data exfiltration or RCE is present, the input handling flaw warrants a 'suspicious' classification.
Capability Assessment
ℹ Purpose & Capability
Name, description, commands, and required credential (CONVERTKIT_API_KEY) align with a ConvertKit integration. The CLI implements subscriber, tag, form, sequence, and broadcast operations as claimed.
⚠ Instruction Scope
SKILL.md states the skill requires CONVERTKIT_API_KEY and that it never stores data locally; it does not mention that the script will search for CONVERTKIT_API_KEY inside a workspace .env file (default: ~/.openclaw/workspace/.env) or that it will consult a WORKSPACE environment variable. That file-read behavior broadens scope beyond the documented instructions and is not declared in SKILL.md.
✓ Install Mechanism
No install spec; this is an instruction-only skill with a single Python stdlib script. No external downloads or package installs are requested.
⚠ Credentials
Only CONVERTKIT_API_KEY is declared and is appropriate for the stated purpose. However, the script also checks an undeclared WORKSPACE env var and reads a .env file under that path (or a default in the user's home). Reading arbitrary workspace .env files can expose other secrets in that file and is not justified or documented in the SKILL.md.
✓ Persistence & Privilege
The skill does not request permanent presence (always:false), does not modify other skills or global settings, and does not write files. It only reads environment or the workspace .env fallback.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install convertkit
  3. After installation, invoke the skill by name or use /convertkit
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the ConvertKit skill for creator email marketing and automation. - Manage subscribers, forms, sequences, broadcasts, tags, and automations via the ConvertKit API. - Provides a Python CLI with commands for subscriber management, tagging, form and sequence operations, broadcasts, and analytics. - No external dependencies; uses Python standard library only. - Outputs results in JSON or human-readable format. - Requires only a ConvertKit API key for setup.
Metadata
Slug convertkit
Version 1.0.0
License —
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Convertkit?

ConvertKit (Kit) creator marketing — manage subscribers, forms, sequences, broadcasts, tags, and automations via the ConvertKit API. Build email lists, creat... It is an AI Agent Skill for Claude Code / OpenClaw, with 411 downloads so far.

How do I install Convertkit?

Run "/install convertkit" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Convertkit free?

Yes, Convertkit is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Convertkit support?

Convertkit is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Convertkit?

It is built and maintained by aiwithabidi (@aiwithabidi); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments