openmates:add-app-skill

Scaffolds and registers an OpenMates app skill with Python skeleton, app.yml config, and multilingual discovery metadata.

43|2|Updated Jan 25, 2024
One-click install
npx skills add https://github.com/glowingkitty/OpenMates --skill openmates-add-app-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openmates:add-app-skill
Source: https://github.com/glowingkitty/OpenMates/tree/main/.claude/skills/add-app-skill
Command: npx skills add https://github.com/glowingkitty/OpenMates --skill openmates-add-app-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating a new app skill in OpenMates usually requires coordinating backend Python code, app YAML registration, and localization entries, which is error-prone and slows down development.

Core Features & Use Cases

  • Scaffold a complete skill skeleton: Generates the request/response Pydantic models and a BaseSkill subclass in the correct app skills folder.
  • Register the skill in app.yml: Adds the required tool schema, provider metadata, and class path so the app can route and expose the skill.
  • Add i18n for names and descriptions: Updates the skills translation source across all supported locales, then instructs rebuilding UI translations.
  • Use an existing skill as a template: Ensures consistency with the target app’s structure, embed behavior, and schema conventions.

Quick Start

Run the command exactly as: add-app-skill <appId> <skillId> <SkillClassName> to scaffold and register a new skill in the specified OpenMates app microservice.

Frequently Asked Questions about openmates:add-app-skill

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

FAQPage Schema
How do I scaffold a new Python skill inside an existing app?

To scaffold a new Python skill, this tool generates a BaseSkill subclass and Pydantic models in the correct app folder, then registers the tool schema and class path in app.yml. It also adds i18n entries across all locales.

How do I register a new tool schema in app.yml?

Registering a new tool schema in app.yml requires adding provider metadata, the class path, and the schema definition. This scaffolding process automatically updates the YAML file to route and expose the new skill to the agent runtime.

What is the best way to add i18n discovery metadata for an app skill?

The best way to add i18n discovery metadata is to update the skills translation source across all supported locales simultaneously. This scaffolder handles the updates and instructs rebuilding UI translations for the new skill names and descriptions.

Does this scaffolding process use Pydantic for request and response models?

Yes, this scaffolding process uses Pydantic for request and response models. It generates typed execute() parameters matching the defined tool_schema, ensuring the BaseSkill subclass aligns with the app’s interface conventions.

Can I use an existing skill as a template when creating a new app skill?

Yes, you can use an existing skill as a template to ensure consistency with the target app’s structure, embed behavior, and schema conventions. This approach maintains alignment with the app’s BaseSkill interface and app.yml schema rules.

What command creates a new skill in an OpenMates app microservice?

To create a new skill in an OpenMates app microservice, run the command: add-app-skill <appId> <skillId> <SkillClassName>. This scaffolds and registers the skill within the specified app environment.