openmaic-classroom

将 RAG 检索结果、文档块或知识图谱概念转换为 OpenMAIC 互动课程。当用户要求将知识库内容、检索到的文档片段、上传的文档、或知识图谱中的概念批量转换为教学课件/互动课堂时使用此技能。支持纯需求生成、基于 PDF 内容的课程生成、和基于概念图遍历的批量课堂生成。

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/preloaded/openmaic-classroom/SKILL.md

Quality

Content

66%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The skill body is highly actionable with a well-structured, validated workflow, but it is weakened by inlining API-reference and requirement-building content that already lives in dedicated reference files, and by repeated sections.

Suggestions

Replace the inlined API request/response JSON, capabilities object, and field tables in Phase 2/3 with a pointer to references/api-reference.md, and reference references/requirement-builder.md from Phase 1.1/1.2 instead of restating requirement-building guidance inline.

De-duplicate the MCP availability check (currently stated in '能力边界', 'MCP 可用性检查', Phase 3, and '注意事项') into a single canonical section and reference it elsewhere.

Consolidate the duplicated '关键约束' block (Phase 1.2 and '概念图遍历 → 批量微课堂') and the duplicated local-mode Base URL handling into one location.

Dimension	Reasoning	Score
Conciseness	The body avoids explaining concepts Claude already knows and is mostly procedural, but contains noticeable duplication — the MCP availability check appears three times, '关键约束' is repeated verbatim, and local-mode Base URL handling is explained twice.	3 / 5
Actionability	Provides concrete, mostly copy-paste-ready guidance: full execute_skill_script invocations with input JSON, API request JSON bodies, field tables, and named MCP tool formats; minor gaps remain in the slightly heuristic MCP-tool identification step.	4 / 5
Workflow Clarity	Phases 1–5 are clearly sequenced with explicit validation checkpoints (health check, feature detection), polling rules, and a manifest-based resume feedback loop for the batch concept-graph operation, plus a 关键约束 checklist.	5 / 5
Progressive Disclosure	api-reference.md and requirement-builder.md exist in the bundle but are never referenced from the body, while API request/response detail and requirement-building guidance are inlined — content that clearly belongs in those separate files is inlined and the references are orphaned.	2 / 5
	Total	14 / 20 Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is specific, third-person, and clearly states both what the skill does and when to use it with concrete trigger phrases. It is distinct and unlikely to be invoked for the wrong skill.

Dimension	Reasoning	Score
Specificity	Names several concrete generation modes ('纯需求生成、基于 PDF 内容的课程生成、和基于概念图遍历的批量课堂生成') and distinct input types (RAG results, document chunks, knowledge-graph concepts) converted to courses, with only minor gaps in describing what generation entails.	4 / 5
Completeness	Explicitly answers both 'what' ('将 RAG 检索结果、文档块或知识图谱概念转换为 OpenMAIC 互动课程') and 'when' ('当用户要求...时使用此技能') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Includes natural user phrases such as '知识库内容', '检索到的文档片段', '上传的文档', '知识图谱中的概念', '批量转换为教学课件/互动课堂', giving good keyword coverage, though a few common synonyms are missing.	4 / 5
Distinctiveness Conflict Risk	Targets a clear named niche (OpenMAIC interactive classrooms from WeKnora RAG/knowledge-graph sources) with distinct triggers, giving minimal conflict risk with other skills.	5 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: Tencent/WeKnora
Path: skills/preloaded/openmaic-classroom/SKILL.md
Commit: b18ae0f

Reviewed: 2 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.