convez.ai
SkillIntermediário
beau-education

Beau Plugin para Claude

beau-education/beau-plugin

Autoria de recursos educacionais e análise de desempenho estudantil

Ver no GitHub
InicialPluginScore · de 0 a 100

Plugin para criar recursos educacionais e avaliar desempenho de estudantes na plataforma de tutoria por voz Beau. Fornece ao Claude capacidades para autoria de recursos, upload de imagens, criação de quizzes, organização de cursos e análise de progresso estudantil.

Instalação

$npx convez-ai beau-education/beau-plugin

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
25%
Último commit
há 1 semana
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Criar e organizar materiais educacionais estruturados com imagens e quizzes
  • Analisar progresso e desempenho de alunos em cursos
  • Gerar diagramas visuais e conteúdo didático para plataforma de tutoria

Veredito

Plugin bem estruturado que integra Claude diretamente com a plataforma Beau via MCP Server. Oferece 32 ferramentas para gestão completa de recursos educacionais, porém requer autenticação OAuth e é específico para usuários da plataforma Beau.

README

A tradução para o português deste README ainda está na fila.

Beau Plugin for Claude Code and Cowork

A plugin for creating educational resources and evaluating student performance on the Beau voice tutoring platform. Gives Claude the knowledge and tools to author resources, upload images, create quizzes, organize courses, and analyse student progress.

This repo is the single source of truth for Beau's skills and user guides. The same skills run in two places, so the experiences stay in lockstep:

  • Claude Code / Cowork — installs this plugin and runs the skills directly.
  • The Beau dashboard's built-in AI assistant — an OpenAI-backed agent (not Claude) that loads SKILL.md from this repo at runtime. The dashboard also fetches the human user guides (below) from this repo at runtime instead of bundling them.

What This Plugin Provides

  • MCP Server Connection: Connects to the Beau API via OAuth 2.1 for resource and student management
  • Create Resource Skill (/beaubot:create-resource): Guides Claude through authoring structured educational resources with images, quizzes, and courses
  • Evaluate Student Skill (/beaubot:evaluate-student): Analyses student performance across courses using transcripts, scores, and progress data

Installation

Claude Code (CLI)

/install-plugin beau-education/beau-plugin

Claude Cowork (Desktop App)

  1. Open Customize panel
  2. Click + next to Personal plugins
  3. Select Add from marketplace
  4. Paste: beau-education/beau-plugin

Claude Web (MCP Connector only)

Claude web doesn't support plugins, but you can add the MCP server as a remote Connector to get access to all tools (without skills):

MCP Server URL: https://api.beau.bot/mcp

Add this as a remote MCP connector. You'll be prompted to authenticate via OAuth with your Beau account. Web users get all 32 tools but not the guided skill workflows.

Usage

Once installed, invoke the skills in any chat:

/beaubot:create-resource    — Author a new educational resource
/beaubot:evaluate-student   — Analyse student performance

Note: The MCP server must be connected before using tools. If you get tool errors, check your MCP connection and re-authenticate if needed.

MCP Tools (32)

Resource Management

ToolDescription
list_resourcesList resources with optional tag filtering
get_resourceFetch a resource by ID
create_resourceCreate a new resource
update_resourceUpdate an existing resource
export_resourceExport a resource as a ZIP archive
import_resourceImport a resource from a ZIP archive

Media

ToolDescription
get_imageDownload an image by ID (returns image visually + metadata)
create_imageUpload an image (base64) to a resource
upload_image_from_urlUpload an image from a public URL
prepare_image_uploadMint a single-use multipart upload URL for a local file (preferred over create_image for files on disk)
generate_imageGenerate an AI image from a text prompt
create_svgAdd a hand-authored SVG diagram to a resource
create_text_image(Deprecated) Render text into a PNG — prefer create_visual kind text

Visuals

Teacher-authored diagrams rendered as crisp SVG/HTML (stored as a media type, shown via display_media).

ToolDescription
create_visualCreate a visual (number line, fraction, grid, chart, geometry, clock, … 24+ kinds)
update_visualUpdate an existing visual's config (kind is immutable)

Quizzes

ToolDescription
create_quizCreate a quiz (single/multiple/freetext/ordered_list/matching/fill_in_blank)
update_quizUpdate an existing quiz

Tags

ToolDescription
list_tagsList available tags in the organization
create_tagCreate a new tag

Courses

ToolDescription
create_courseCreate a course
list_coursesList courses
add_resource_to_courseAdd a resource to a course
list_course_resourcesList resources in a course with order and bot details

Bots

ToolDescription
list_botsList the org's AI tutor bots (persona, voice, avatar)
get_botGet a bot's details

Users & Students

ToolDescription
list_usersList users in the organization
get_userGet user details
list_enrollmentsList student enrollments
get_enrollment_progressGet detailed progress for an enrollment
get_student_statsGet aggregated statistics for a student
get_student_activityGet recent activity log for a student
get_transcriptGet the conversation transcript for a lesson

User guides (source of truth)

The Beau dashboard's in-app help and role dashboards fetch these guides from this repo at runtime (via the API), so there are no duplicated copies in the app — edit them here.

GuidePathaudience
Adminguides/admin-guide.md[admin] (human)
Studentguides/student-guide.md[student] (human)
Teacherbeaubot/skills/create-resource/teacher-guide.md[teacher, admin] (human)
Resource (authoring)beaubot/skills/create-resource/resource-creation-guide.md[teacher, admin, agent] (human + AI)

Each guide carries audience / title frontmatter (stripped before display). audience lists the dashboard roles a guide is for, plus agent for guides the AI authoring assistant should treat as reference. Human-UI guides (guides/) live outside skills/ so skill discovery ignores them.

Keep in sync: the guides, the skill instructions (SKILL.md), and the API's MCP tool descriptions all describe the same capabilities — when a tool gains a capability (e.g. a new visual kind or quiz type), update all of them together.

Authentication

The MCP server uses OAuth 2.1 with Auth0. When you first use a tool, you'll be prompted to authenticate with your Beau account. Your organization's data is scoped to your Auth0 organization.

License

MIT

Ver o original no GitHub

Bom para

Relacionados