astrbot-plugin-dev

Develop AstrBot v4.26.5+ plugins with validation scripts and API references.

1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/2718labs/2718lab-devkit --skill astrbot-plugin-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: astrbot-plugin-dev
Source: https://github.com/2718labs/2718lab-devkit/tree/main/skills/astrbot-plugin-dev
Command: npx skills add https://github.com/2718labs/2718lab-devkit --skill astrbot-plugin-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill prevents common development pitfalls and architectural errors when building AstrBot plugins, ensuring your code adheres to the latest v4.26.5+ framework standards and team-specific best practices.

Core Features & Use Cases

  • Standardized Architecture: Provides the exact file structure, metadata requirements, and main.py boilerplate needed for a production-ready plugin.
  • Lifecycle Management: Enforces correct resource cleanup (terminate) and data persistence (get_data_dir) to prevent memory leaks and data loss during hot-reloads.
  • Use Case: When you need to build a new QQ or Telegram bot plugin, use this Skill to generate the correct metadata, implement the Star class correctly, and ensure your LLM tools are registered without triggering common framework exceptions.

Quick Start

Use the astrbot-plugin-dev skill to validate your current plugin directory structure and main.py code against the team's baseline requirements.

Frequently Asked Questions about astrbot-plugin-dev

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

FAQPage Schema
How do I develop a chatbot plugin that complies with the AstrBot v4.26.5+ framework standards?

You must follow standardized architecture by implementing the correct file structure, metadata requirements, and main.py boilerplate to ensure your chatbot plugin adheres to v4.26.5+ framework standards.

How do I prevent memory leaks and data loss during AstrBot plugin hot-reloads?

To prevent memory leaks and data loss during hot-reloads, you must enforce correct resource cleanup using the terminate method and manage data persistence through the get_data_dir functionality in your plugin lifecycle.

What is the correct way to register LLM tools in an AstrBot plugin without triggering framework exceptions?

Registering LLM tools correctly requires using the provided main.py boilerplate and adhering to API references to ensure tools are integrated without triggering common framework exceptions.

Can I use the AstrBot plugin development guidelines to build bots for both QQ and Telegram?

Yes, these development guidelines provide the project scaffolding and architectural constraints needed to build and deploy production-ready chatbot plugins for platforms like QQ and Telegram.

How do I validate my current AstrBot plugin directory structure against team baseline requirements?

You can validate your current plugin directory structure and main.py code by running the provided validation scripts to check your project against the team's baseline architectural constraints and security standards.

What are the common architectural pitfalls when building AstrBot plugins?

Common architectural pitfalls include incorrect metadata configuration, improper Star class implementation, and failing to manage resource cleanup, which are prevented by following team-validated architectural constraints.