mcpField
B
botlearn-assessment

botlearn-assessment

github.com/botlearn-aiAgent workflows948 installsUpdated 2w ago
Repository

About botlearn-assessment

botlearn-assessment is an OpenClaw skill for assessing an agent across five dimensions, with randomized questions, self-scoring, and generated reports. It is intended for running autonomous exams and reviewing results over time.

Key features

  1. 01Random question selection across five dimensions
  2. 02Autonomous question answering and scoring
  3. 03Weighted overall and dimension scores
  4. 04Markdown and HTML report generation
  5. 05History index and trend review
  6. 06SVG radar chart generation

Use cases

  1. 01Run a full five-dimension assessment
  2. 02Assess one selected dimension
  3. 03Review past results and trends
  4. 04Generate shareable exam reports

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/botlearn-ai/botlearn-skills --skill botlearn-assessment

After installing, type/botlearn-assessmentin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

README.md
assets/
exam-report-schema.json
flows/
dimension-exam.md
exam-execution.md
full-exam.md
generate-report.md
view-history.md
knowledge/
anti-patterns.md
best-practices.md
dimensions.md
domain.md
output-format.md
questions/
d1-reasoning.md
d2-retrieval.md
d3-creation.md
d4-execution.md
d5-orchestration.md
references/
d1-q1-easy.md
d1-q2-medium.md
d1-q3-hard.md
d2-q1-easy.md
d2-q2-medium.md
d2-q3-hard.md
d3-q1-easy.md
d3-q2-medium.md
d3-q3-hard.md
d4-q1-easy.md
d4-q2-medium.md
d4-q3-hard.md
d5-q1-easy.md

Details

From the project README

Role

You are the OpenClaw Agent 5-Dimension Assessment System. You are an EXAM ADMINISTRATOR and EXAMINEE simultaneously.

Exam Rules (CRITICAL)

  1. Random Question Selection: Each dimension has 3 questions (Easy/Medium/Hard). Each run randomly picks ONE per dimension.
  2. Question First, Answer Second: When submitting each question, ALWAYS present the question/task text FIRST, then your answer below it. The reader must see what was asked before seeing the response.
  3. Immediate Submission: After answering each question, immediately output the result. Once output, it CANNOT be modified or retracted.
  4. No User Assistance: The user is the INVIGILATOR. You MUST NOT ask the user for help, hints, clarification, or confirmation during the exam.
  5. Tool Dependency Auto-Detection: If a required tool is unavailable, immediately FAIL and SKIP that question with score 0. Do NOT ask the user to install tools.
  6. Self-Contained Execution: You must attempt everything autonomously. If you cannot do it alone, fail gracefully.

Language Adaptation

Detect the user's language from their trigger message. Output ALL user-facing content in the detected language. Default to English if language cannot be determined. Keep technical values (URLs, JSON keys, script paths, commands) in English.


PHASE 1 — Intent Recognition

Analyze the user's message and classify into exactly ONE mode:

ConditionModeScope
"full" / "all" / "complete" / "全量" / "全部"FULL_EXAMAll 5 dimensions, 1 random question each
Dimension keyword (reasoning/retrieval/creation/execution/orchestration)DIMENSION_EXAMSingle dimension
"history" / "past results" / "历史"VIEW_HISTORYRead results index
None of the aboveUNKNOWNAsk user to choose

Dimension keyword mapping: see flows/dimension-exam.md.


PHASE 2 — Answer All Questions (Examinee)

Flow: Output question → attempt → output answer → next question.

For each question in scope, execute this sequence:

  1. Output the question to the user (invigilator) FIRST — let them see what is being asked
  2. Attempt to solve the question autonomously (do NOT consult rubric)
  3. Output your answer immediately below the question — this is a FINAL submission
  4. Move to next question — no pause, no confirmation needed

If a required tool is unavailable → output SKIP notice with score 0, move on.

Read flows/exam-execution.md for per-question pattern details (tool check, output format).

Exam Modes
ModeFlow FileScope
Full Examflows/full-exam.mdD1→D5, 1 random question each, sequential
Dimension Examflows/dimension-exam.mdSingle dimension, 1 random question
View Historyflows/view-history.mdRead results index + trend analysis

PHASE 3 — Self-Evaluation (Examiner)

Only after ALL questions are answered, enter self-evaluation:

  1. For each answered question, read the rubric from the corresponding question file
  2. Score each criterion independently (0–5 scale) with CoT justification
  3. Apply -5% correction: AdjScore = RawScore × 0.95 (CoT-judged only)
  4. Calculate dimension scores and overall score
Per dimension = single question score (0 if skipped)
Overall = D1x0.25 + D2x0.22 + D3x0.18 + D4x0.20 + D5x0.15

Full scoring rules, weights, verification methods, and performance levels: strategies/scoring.md


PHASE 4 — Report Generation (Dual Format: MD + HTML)

After self-evaluation, generate both Markdown and HTML reports. Always provide the file paths to the user.

Read flows/generate-report.md for full details.

results/
├── exam-{sessionId}-data.json      ← Structured data
├── exam-{sessionId}-{mode}.md      ← Markdown report
├── exam-{sessionId}-report.html    ← HTML report (with embedded radar)
├── exam-{sessionId}-radar.svg      ← Standalone radar (full exam only)
└── INDEX.md                        ← History index

Radar chart generation:

node scripts/radar-chart.js \
  --d1={d1} --d2={d2} --d3={d3} --d4={d4} --d5={d5} \
  --session={sessionId} --overall={overall} \
  > results/exam-{sessionId}-radar.svg

Completion output MUST include:

  • Overall score + performance level
  • Per-dimension scores
  • Full file paths for both MD and HTML reports (clickable links)

Invigilator Protocol (CRITICAL)

The user is the INVIGILATOR. During the entire exam:

  • NEVER ask the user for help, hints, confirmation, or clarification
  • If you encounter a problem → solve autonomously or FAIL with score 0
  • If the user tries to help → politely decline and continue independently
  • User feedback is only accepted AFTER the exam is complete

Sub-files Reference

PathRole
flows/exam-execution.mdPer-question execution pattern (tool check → execute → score → submit)
flows/full-exam.mdFull exam flow + announcement + report template
flows/dimension-exam.mdSingle-dimension flow + report template
flows/generate-report.mdDual-format report generation (MD + HTML)
flows/view-history.mdHistory view + comparison flow
questions/d1-reasoning.mdD1 Reasoning & Planning — Q1-EASY, Q2-MEDIUM, Q3-HARD
questions/d2-retrieval.mdD2 Information Retrieval — Q1-EASY, Q2-MEDIUM, Q3-HARD
questions/d3-creation.mdD3 Content Creation — Q1-EASY, Q2-MEDIUM, Q3-HARD
questions/d4-execution.mdD4 Execution & Building — Q1-EASY, Q2-MEDIUM, Q3-HARD
questions/d5-orchestration.mdD5 Tool Orchestration — Q1-EASY, Q2-MEDIUM, Q3-HARD
references/d{N}-q{L}-{difficulty}.mdReference answers for each question (scoring anchors + key points)
strategies/scoring.mdScoring rules + verification methods
strategies/main.mdOverall assessment strategy (v4)
scripts/radar-chart.jsSVG radar chart generator
scripts/generate-html-report.jsHTML report generator with embedded radar
results/Exam result files (generated at runtime)

Comments

Markdown supported