← Back to Skills Marketplace
Balzac
by
Vincenzo Ruggiero
· GitHub ↗
· v1.0.9
· MIT-0
122
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install balzac
Description
AI content platform CLI — create workspaces, manage SEO keywords, generate article suggestions, write articles, and publish to WordPress, Webflow, Wix, GoHig...
README (SKILL.md)
Balzac CLI
AI-powered SEO content platform. Authenticate, create a workspace from any domain, and Balzac analyzes your site, generates keyword-driven article suggestions, writes SEO-optimized articles, and publishes them.
npm install -g balzac-cli
Get an API key: https://app.hirebalzac.ai/api_keys
Setup
export BALZAC_API_KEY=bz_your_key_here
# Or: balzac auth login bz_your_key_here
balzac config set workspace \x3Cworkspace-id> # set default workspace
Core Workflow
# 1. Create workspace from a domain
balzac workspaces create --domain https://myblog.com --wait
balzac config set workspace "$(balzac --json workspaces list | jq -r '.workspaces[0].id')"
# 2. Generate suggestions and accept one (5 credits)
balzac suggestions generate # costs 1 credit
sleep 30
balzac suggestions list --status proposed
balzac suggestions accept \x3Csuggestion-id> # costs 5 credits
# 3. Or write directly from a topic (5 credits)
balzac write "How to use AI for content marketing" --wait
# 4. Export or publish
balzac articles export \x3Cid> --format markdown
balzac articles publish \x3Cid> --integration \x3Cintegration-id>
Commands
| Command | What it does |
|---|---|
balzac workspaces list/create/get/delete |
Manage workspaces |
balzac keywords list/create/enable/disable |
Manage SEO keywords |
balzac suggestions list/generate/accept/reject |
AI article suggestions |
balzac briefings create --topic "..." |
Direct write instruction (5 cr) |
balzac write "topic" [--wait] |
Shortcut: briefing + optional wait |
balzac articles list/get/export/rewrite/publish |
Manage articles |
balzac articles regenerate-picture \x3Cid> |
New cover image (1 cr) |
balzac competitors list/add/remove |
Track competitor domains |
balzac links list/add/remove |
Reference links for articles |
balzac integrations list/create/get/reconnect |
Publishing integrations |
balzac settings get/update |
Workspace settings |
balzac tones list |
Available tones of voice |
balzac config set/get/reset |
CLI configuration |
Credit Costs
| Action | Credits |
|---|---|
| Generate 10 suggestions | 1 |
| Write article (accept suggestion or create briefing) | 5 |
| Rewrite article | 3 |
| Regenerate picture | 1 |
Key Notes
- Use
--jsonflag for scriptable JSON output; pipe tojq. - Use
-w \x3Cid>orbalzac config set workspace \x3Cid>for workspace-scoped commands. - Article writing is async — use
write --waitor pollarticles get \x3Cid>. - Workspace creation is async — use
--waitflag. - Supported integrations: WordPress, Webflow, Wix, GoHighLevel, Webhook.
- Run
balzac \x3Ccommand> --helpfor full option details.
Usage Guidance
This skill appears coherent for controlling the Balzac CLI. Before installing: 1) Verify the npm package 'balzac-cli' and its publisher on npm (review downloads, repository link, and recent releases) before running a global install. 2) Only supply a BALZAC_API_KEY you trust; review Balzac's privacy/terms because article content and site data will be sent to their service. 3) Integrations (WordPress/Webflow/Wix/etc.) will require additional credentials or tokens stored by the CLI—provide those only to trusted services and consider using least-privilege accounts. 4) If you allow autonomous agent invocation, remember the agent could run balzac CLI commands using the provided API key; keep keys scoped and rotate/revoke if needed. 5) Note the registry metadata omission of a formal install spec is minor but you may want to inspect the upstream project and homepage (https://developer.hirebalzac.ai) before proceeding.
Capability Analysis
Type: OpenClaw Skill
Name: balzac
Version: 1.0.9
The skill bundle provides documentation and integration instructions for the 'Balzac CLI', a legitimate AI content platform. It utilizes a standard npm package (balzac-cli) and requires an API key for its own service (hirebalzac.ai). No evidence of malicious intent, data exfiltration, or prompt injection was found; the instructions are strictly functional and aligned with the stated purpose of managing SEO content.
Capability Assessment
Purpose & Capability
Name/description, required binary ('balzac'), and required env var (BALZAC_API_KEY) align with a CLI that talks to the Balzac service and publishes content. The supported integrations (WordPress, Webflow, etc.) are consistent with the skill's stated purpose.
Instruction Scope
SKILL.md limits actions to installing/using the balzac CLI and using BALZAC_API_KEY; commands shown call the CLI and pipe JSON to jq. There are no instructions to read unrelated system files or export unrelated credentials. Publishing/integration steps will contact external services, which is expected for this tool.
Install Mechanism
There is no registry-level install spec, but SKILL.md recommends installing the official-looking npm package (npm install -g balzac-cli). Installing an npm CLI is a reasonable install method for this purpose; users should still verify the npm package and publisher before global install.
Credentials
Only one env var (BALZAC_API_KEY) is required and is directly related to the service. The skill does not request unrelated credentials or system config paths.
Persistence & Privilege
always:false (no forced presence). The skill is user-invocable and allows normal autonomous invocation, which is the platform default and appropriate here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install balzac - After installation, invoke the skill by name or use
/balzac - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.9
- Added detailed SKILL.md documenting Balzac CLI setup, usage, commands, and credit costs
- Explains authentication, workspace creation, article suggestions, writing, and publishing workflows
- Lists all major CLI commands with clear descriptions and parameters
- Outlines integration options (WordPress, Webflow, Wix, GoHighLevel, Webhook)
- Provides guidance on async command usage and workspace management
- Clarifies credit spending for various actions
Metadata
Frequently Asked Questions
What is Balzac?
AI content platform CLI — create workspaces, manage SEO keywords, generate article suggestions, write articles, and publish to WordPress, Webflow, Wix, GoHig... It is an AI Agent Skill for Claude Code / OpenClaw, with 122 downloads so far.
How do I install Balzac?
Run "/install balzac" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Balzac free?
Yes, Balzac is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Balzac support?
Balzac is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Balzac?
It is built and maintained by Vincenzo Ruggiero (@vincenzor); the current version is v1.0.9.
More Skills