Frappecli

**Quick judgment**: This is a powerful, narrowly scoped skill for interacting with *existing* Frappe Framework / ERPNext instances over REST. It is well-suited for admins and power users who explicitly want to manage live data (doctypes, documents, files, reports, and RPC) from within an agent. Because it supports full write and delete operations, it should be treated as a high-impact skill and used cautiously on production systems. **Where this skill shines** - Managing real Frappe/ERPNext sites when the user provides (or has preconfigured) valid API credentials. - Listing and inspecting doctypes and document schemas when the user asks about the structure of their Frappe site. - Performing concrete data operations: listing, creating, updating, and deleting records (e.g., Customers, Sales Invoices) with filters and field selection. - Running built-in reports (like General Ledger or Accounts Receivable) and exporting them as JSON/CSV for analysis or download. - Handling file attachments: uploading invoices or assets, downloading files, and listing files linked to specific documents. - Invoking custom server-side RPC methods to run bespoke business logic. **Key risks / cautions** - **Destructive operations**: Document deletion and updates can cause irreversible data loss or business impact if used incorrectly. The agent should: - Ask for explicit confirmation before any `delete` or broadly scoped `update`/bulk operations. - Prefer operating on staging/test sites when possible. - **Security & privacy**: The skill uses API keys/secrets stored in user config. It accesses potentially sensitive business data (customers, financial reports, invoices, files). The agent must: - Avoid exposing secrets or raw internal identifiers in responses unless necessary. - Not log or echo configuration details (URLs, keys, secrets). - **Context appropriateness**: This tool is **not** for generic ERPNext or Frappe conceptual questions. It should only be invoked when the user clearly intends to interact with their own Frappe/ERPNext instance or data. **Recommended scenarios** Use this skill when: - The user explicitly mentions working with a Frappe/ERPNext site and wants to list, query, or manipulate real data (e.g., “list active customers”, “get invoice INV-001”, “run General Ledger report”). - The user wants to upload/download files attached to ERPNext documents. - The user needs to run standard or custom reports and receive them as JSON/CSV. - The user asks to trigger or debug custom server-side methods exposed via Frappe RPC. Avoid or be very cautious when: - The request is purely theoretical or documentation-related (better answered without hitting a real site). - The requested operation would modify or delete large amounts of data without clear filters. - The user’s intent is ambiguous about which environment (production vs. staging) to target; clarify before executing.