← Back to Skills Marketplace
ocruzv

FactuCat CLI

by Omar Cruz · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
142
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install factucat-cli
Description
Use this skill when an agent needs to install, update, authenticate, or operate the FactuCat CLI to create Mexican CFDI 4.0 invoice drafts, assign customers...
README (SKILL.md)

FactuCat CLI

FactuCat CLI operates FactuCat Cloud from the command line. It is specifically for Mexican CFDI 4.0 invoicing, not for generic invoicing or self-hosted deployments.

Use This Skill When

  • A user wants to install or update the FactuCat CLI
  • A user needs to authenticate with a FactuCat API key
  • An agent needs to create, edit, preview, or stamp CFDI drafts from the terminal
  • A workflow needs unattended CLI execution with --json and --no-input
  • A user wants to download XML or PDF artifacts for a stamped invoice

Operating Rules

  • Treat https://factucat.com as the production service endpoint
  • Use Mexican CFDI and SAT terminology in explanations and examples
  • Prefer interactive flows for humans in a TTY
  • Prefer --json and --no-input for agents, scripts, and deterministic automation
  • Use factucat invoice show for the full preview before timbrado
  • When a task involves fiscal vocabulary or CFDI semantics, read references/mexico-cfdi-context.md

Workflow Guide

  1. For installation, updates, and authentication, read references/install-and-auth.md
  2. For a human-operated invoice flow, read references/interactive-flows.md
  3. For agent or script execution, read references/unattended-flows.md
  4. If anything fails, read references/troubleshooting.md

Practical Notes

  • factucat invoice create --customer "..." is a shortcut that creates a draft and tries to resolve a customer by name or RFC
  • factucat invoice add-item can infer SAT product code, SAT unit code, IVA, and retained ISR if omitted
  • factucat invoice set-meta --currency USD can infer the official DOF exchange rate if --exchange-rate is omitted
  • factucat invoice stamp can be interactive and ask about sending the stamped invoice through registered customer contact channels
  • For issued invoices, commands that accept an invoice reference can usually take either a UUID or folio
Usage Guidance
This skill appears to do what it says, but take common-sense precautions before installing and using it: verify the npm package owner and the GitHub repository (ensure @factucat/cli is the official package), review the package contents or install in a sandbox if you distrust it, and do not paste your production FACTUCAT_API_KEY into unfamiliar or untrusted environments. Note the SKILL.md's unusual UX detail (typing a Konami code in the site to reveal the API keys) — this is odd but product-specific rather than a security indicator. If you need stricter control, create a scoped or test API key on factucat.com with limited permissions and use that with agent automation.
Capability Analysis
Type: OpenClaw Skill Name: factucat-cli Version: 1.0.0 The factucat-cli skill bundle is a legitimate toolset for managing Mexican CFDI 4.0 invoicing via the FactuCat service. It provides standard instructions for installing the official npm package (@factucat/cli), authenticating with an API key, and executing invoicing workflows. No indicators of data exfiltration, malicious execution, or harmful prompt injection were found; the 'Konami code' mentioned in the documentation is a UI feature for the service's web portal and does not pose a security risk to the agent or environment.
Capability Assessment
✓ Purpose & Capability
Name/description, declared binary requirement (factucat), primary credential (FACTUCAT_API_KEY), and examples in SKILL.md all consistently reference operating the FactuCat CLI and FactuCat service (factucat.com). There are no unrelated credentials or binaries requested.
✓ Instruction Scope
SKILL.md instructs installation, authentication, interactive and unattended CLI usage and references local README-style files for flows and troubleshooting. The instructions only reference the factucat binary, the FactuCat site, and local reference files; they do not request reading arbitrary system files or exfiltrating data to unexpected endpoints.
ℹ Install Mechanism
Install uses npm (@factucat/cli) to create the factucat binary — this is a standard and expected mechanism for a JS-based CLI. npm packages carry moderate trust implications (third-party code execution), so verifying the package source/maintainer before installing is advised.
✓ Credentials
The only declared credential is FACTUCAT_API_KEY (the skill's primaryEnv). No unrelated environment variables or config paths are requested. The use of an API key is proportional to a CLI that authenticates to a remote invoicing service.
✓ Persistence & Privilege
The skill does not request always:true or elevated persistent privileges. It is user-invocable and permits autonomous invocation by default (platform normal). There is no indication it modifies other skills or system-wide agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install factucat-cli
  3. After installation, invoke the skill by name or use /factucat-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of factucat-cli skill: - Provides guidance for installing, updating, and authenticating the FactuCat CLI. - Supports creating, editing, previewing, and stamping Mexican CFDI 4.0 invoices via the terminal. - Includes workflow guides for both interactive (human) and unattended (agent/script) CLI usage. - Details commands for assigning customer data, adding invoice concepts, and downloading XML/PDF invoice artifacts. - Emphasizes correct use of CFDI and SAT fiscal terminology and best practices.
Metadata
Slug factucat-cli
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is FactuCat CLI?

Use this skill when an agent needs to install, update, authenticate, or operate the FactuCat CLI to create Mexican CFDI 4.0 invoice drafts, assign customers... It is an AI Agent Skill for Claude Code / OpenClaw, with 142 downloads so far.

How do I install FactuCat CLI?

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

Is FactuCat CLI free?

Yes, FactuCat CLI is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does FactuCat CLI support?

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

Who created FactuCat CLI?

It is built and maintained by Omar Cruz (@ocruzv); 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