create-minapp-project-action

Guide developers through adding new AppAction types to Minapp projects.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/tokijh/minapp --skill create-minapp-project-action
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-minapp-project-action
Source: https://github.com/tokijh/minapp/tree/main/.claude/skills/create-minapp-project-action
Command: npx skills add https://github.com/tokijh/minapp --skill create-minapp-project-action

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the process of adding new action types to a Minapp project's AppSpec, ensuring consistency and proper integration across the application's action system.

Core Features & Use Cases

  • Action Type Integration: Adds new action types (e.g., custom API calls, UI interactions) to the AppAction union.
  • Runtime Handler Implementation: Guides the implementation of corresponding logic within the application's action execution engine.
  • Server API Creation: Facilitates the creation of necessary server-side API routes for actions requiring backend processing.
  • Agent Prompt & Catalog Updates: Ensures the AI agent is aware of and can utilize the new action type by updating its system prompt and component catalog.
  • Use Case: When developing a new feature that requires a unique user interaction or data fetching mechanism, this Skill provides a step-by-step guide to integrate it seamlessly as a new AppAction.

Quick Start

Follow the steps in the SKILL.md file to add a new 'CUSTOM_ACTION' type to your Minapp project.

Frequently Asked Questions about create-minapp-project-action

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new AppAction type to a Minapp project?

Adding a new AppAction type requires defining the type in the AppSpec union, implementing the runtime handler logic, creating server API routes for backend processing, and updating the agent prompt and component catalog to ensure the new action is fully integrated and discoverable within the Minapp ecosystem.

What does updating the Minapp component catalog do for new actions?

Updating the component catalog ensures new AppAction types are discoverable by the AI agent. By maintaining the catalog and updating the agent system prompt, the Minapp ecosystem recognizes and can successfully execute the newly integrated action type.

Do I need to create server API routes for every new Minapp action?

Server API routes are necessary for new Minapp actions requiring backend processing, such as custom API calls or data fetching. Actions limited to UI interactions may bypass server route creation and focus solely on the runtime handler implementation.

How does the Minapp action execution engine handle new AppAction types?

The Minapp action execution engine processes new AppAction types via runtime handler implementation. After defining the custom action in the AppAction union, the engine routes execution to the specific handler logic you implement for that unique interaction or data fetching mechanism.

What is the best way to integrate custom API calls into a Minapp application?

Integrating custom API calls is best achieved by adding them as a new AppAction type. This involves defining the action type, implementing the runtime handler, creating server API routes for backend processing, and updating the agent prompt to ensure seamless integration within the Minapp ecosystem.