Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AppGini AXP Editor Skill

AppGini is a super-fast no-code generator that turns a visual schema into secure, collaborative, responsive web database apps in minutes. 🚀

AppGini project files are XML files with the .axp extension. This skill helps AI coding agents create, edit, review, and validate AppGini .axp project files.

Why ask an AI agent to create or edit AppGini AXP files instead of generating the entire app?

  • 💰 Save tokens — Generate only the compact AXP file instead of the full PHP/HTML/CSS/JS codebase.
  • ⏱️ Save time — Let the AI focus on schema design and AppGini-specific properties. Get a ready AXP in under a minute, then let AppGini generate the polished application in seconds.
  • 🛡️ Battle-tested features included — Authentication, RBAC, user management, groups & permissions, admin/user dashboards, lookups, calculated fields, file uploads, maps, images, videos, powerful search, CSV import/export, and 20+ years of real-world best practices are handled automatically by AppGini.
  • 💬 Simplify prompting — Instead of asking the AI to include all the above features in a custom app, just ask it to create an AppGini AXP file with the desired business-domain details. No need to prompt for authentication, RBAC, or other features that AppGini already provides.

📦 Installation

Compatible with OpenCode, Claude Code, and other harnesses that support the AgentSkills specification. Install globally (available to all projects) or locally (current repository only).

Prerequisites

  • Git
  • Node.js (for the recommended npx method)
  • AppGini (Free or Pro) to generate the final application from the .axp file

Option 1: Automatic Installation and updates (Recommended)

Global

npx skills add bigprof-software/appgini-axp-editor --global

Project-local (run inside your project root)

npx skills add bigprof-software/appgini-axp-editor

When a new version of the skill is released, update it with:

npx skills update bigprof-software/appgini-axp-editor

Option 2: Manual Installation and updates (if you cannot use npx)

Global

OpenCode:

mkdir -p ~/.config/opencode/skills
git clone https://github.com/bigprof-software/appgini-axp-editor.git ~/.config/opencode/skills/appgini-axp-editor

Claude Code / Universal:

mkdir -p ~/.claude/skills
git clone https://github.com/bigprof-software/appgini-axp-editor.git ~/.claude/skills/appgini-axp-editor

Project-local (run from your project root)

OpenCode:

mkdir -p .opencode/skills
git clone https://github.com/bigprof-software/appgini-axp-editor.git .opencode/skills/appgini-axp-editor

Claude Code / Universal:

mkdir -p .claude/skills
git clone https://github.com/bigprof-software/appgini-axp-editor.git .claude/skills/appgini-axp-editor

To update the skill, navigate to the skill folder and pull the latest changes:

cd ~/.config/opencode/skills/appgini-axp-editor # or wherever you installed it
git pull

Verify Installation

Restart your AI coding tool and ask it what AppGini AXP skills it has, or confirm that SKILL.md is accessible to the agent.

🚀 Quick Start

  1. Install the skill (above).
  2. Prompt your AI agent with requests such as:
    • “Create a new AppGini AXP for an inventory management system with products, suppliers, categories, and orders.”
    • “Add a lookup field and a calculated total to this existing AXP.”
    • “Review and validate this AXP against AppGini best practices.”
    • “Generate a minimal valid AXP for a simple contacts app.”
  3. The agent produces or edits a valid .axp file following the rules in SKILL.md.
  4. Open the .axp in AppGini → Generate the app → Deploy to any PHP 8 + MySQL/MariaDB host.

See the examples/ folder for ready-to-use starting points.

📁 Files

Primary

  • SKILL.mdStart here. Lean overview with core rules, conventions, workflows, validation checklist, scope limits, and navigation to detailed reference files.

References

  • references/appgini-app-properties.md — All <database>-level properties (encoding, locale, theme, homepage, admin, PWA, etc.)
  • references/appgini-table-properties.md — All <table>-level properties (data features, display, TV templates, parent-child, etc.)
  • references/appgini-field-properties.md — All <field>-level properties (data types, uploads, lookups, calculated fields, etc.)
  • references/appgini-data-types.md — The AppGini data types with usage notes and restrictions
  • references/appgini-timezones.md — All supported PHP timezone identifiers for <timeZone>
  • references/table-icons.md — Complete list of included AppGini table icons
  • references/field-rules.md — All field-type rules: lookups, uploads, calculated fields, value lists, filters panel, etc.
  • references/table-rules.md — Table-level rules: required properties, groups, visibility
  • references/descriptions-guide.md — Guide for writing effective table and field <description> text
  • references/cli-generation.md — AppGini Pro command-line generation and deployment reference

Examples

  • examples/minimal-valid.axp — Minimal single-table starting template
  • examples/sales_example.axp — Complete 3-table example with lookups, calculated fields, uploads, and parent-child settings

Evaluations

  • evaluations/create-new-axp.json — Eval: create a new AXP from scratch
  • evaluations/edit-existing-axp.json — Eval: edit an existing AXP file
  • evaluations/review-axp.json — Eval: review a deliberately flawed AXP
  • evaluations/test-fixtures/flawed-app.axp — Test fixture for the review eval

⚠️ Important Scope Rules

AppGini already provides robust user management, authentication, groups, permissions, and RBAC.
Do not model users, groups, permissions, or login-related tables/fields in the AXP unless there is a domain-specific business need.

📋 Requirements & Compatibility

  • Skill: Works with OpenCode, Claude Code, and AgentSkills-compatible tools.
  • AppGini executable: Windows application (can run on macOS/Linux via Parallels, VMware, or Wine).
  • Generated apps: Standard PHP 8.0+ scripts + MySQL 5.6+ or MariaDB 10+. Host on any LAMP, WAMP, MAMP, cPanel, Plesk, or cloud provider (AWS, DigitalOcean, Azure, etc.).
  • License note: AppGini Free Edition is available for evaluation; Pro is a one-time purchase with optional renewals for updates.

⚡ AppGini Pro: Automated Generation & Deployment

If you have AppGini Pro, the AI agent can also generate and deploy your app directly from the command line — no need to open the AppGini GUI manually.

When instructed, the agent will craft and run the appropriate AppGini CLI command for you.

🛠️ What This Skill Does (and Does Not Do)

Does: Create, edit, review, and validate .axp schema files with correct AppGini properties, relationships, and best practices. With AppGini Pro, also run command-line generation and deployment.

Does not: Generate the final PHP application code or write custom hooks. Those steps are performed by AppGini itself (via the GUI or CLI).

🔗 Support & Resources


Made for use with AppGini by BigProf Software.

Build secure, multi-user, fully-owned web database apps in minutes — no coding required.

About

An agentic skill to create, edit, review, and validate AppGini project files that define application-domain database schemas, tables, fields, lookup relationships, uploads, calculated fields, and AppGini UI metadata.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors