erpclaw_skill

Overview

This skill is the ERPClaw setup guide: a read-only, AI-native installer advisor that helps small businesses get an ERP instance up and running. It inspects installed modules, recommends the next install steps, and can seed demo data to explore workflows. It does not modify application tables and never runs raw SQL.

How this skill works

The skill runs the db_query.py script with curated actions (check-installation, install-guide, seed-demo-data) to read the local SQLite state and filesystem. It parses JSON output and returns concise install checklists, tiered install commands, and onboarding steps. If a requested operation has no corresponding action, the skill will say so instead of falling back to raw SQL.

When to use it

• You’re installing ERPClaw for the first time and need guided steps.
• You want to know which modules are already installed and what’s missing.
• You need a prioritized install plan (foundation → accounting → supply chain → ops).
• You want to populate safe demo data to explore features without real data.
• You need copy-pasteable install commands for CLI installation.

Best practices

• Always run python3 {baseDir}/scripts/db_query.py --action check-installation before changing installs.
• Install tiers in order: start with erpclaw-setup and erpclaw-gl, then progress to accounting and supply chain.
• Do not run raw SQL against the database; use skill actions for all queries and writes.
• Use seed-demo-data for trialing workflows; keep production data separate and backed up.
• Check Python 3.10+ and local file permissions if scripts report import or DB errors.

Example use cases

• Fresh install: run check-installation, then clawhub install erpclaw-setup to create your company.
• Assess readiness: run install-guide to get personalized next-step install commands.
• Explore features: run seed-demo-data to create a demo company and sample transactions.
• Scale installs: run the Tier commands to add inventory, sales, payroll, or regional modules in order.
• Troubleshoot: if the DB file is missing, recommend installing erpclaw-setup to initialize the database.