SkillFoxx

Assignment Check skill

A skill that checks coursework against the brief and matches each requirement to evidence in text, numbers and citations.

  • 53 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • The skill reads the brief and your work and may run calculations on your machine to check code.
All reasons and checks

henryyu333/assignment-checkAuthor:henryyu333

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/assignment-check

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The skill reads the brief and your work and may run calculations on your machine to check code.

This is third-party code. Review the repository files before installing.

What it does

Assignment Check splits the teacher's brief, rubric and extra requirements into separate checkable items and looks in the student's work for evidence of each. The skill recalculates data, inspects code and verifies citations and key facts. The reply lists completed requirements, ones only mentioned without the required action, problems found in conclusions, citations, code and data, and the 1–3 fixes to start with. After edits the check repeats: the skill marks what is resolved, what remains, what is new and where something regressed. The author sets clear limits: it is no AI detector, plagiarism checker or grader, only a check before submission. It ships a checking protocol in `references/checking-protocol.md` and 20 test cases.

Who it is for. Students who want to confirm before submitting that the work meets every requirement of the brief.

Good fit when

  • Before handing in an essay, check that every rubric point is covered.
  • A report table is recalculated because the numbers look doubtful.
  • A paper is checked so that sources really support the claims they are cited for.
  • After edits you want to see which findings are closed and which came back.

Not a fit when

  • You need a verdict on whether AI wrote the work.
  • You need a plagiarism check.
  • The teacher gave no brief or rubric, so there is nothing to check against.

Example request

Check my essay against brief.md and show which requirements are met only on the surface.

Limitations

The check works only when the brief and the work itself are present. The README is in Chinese and English, and the skill targets students and does not replace the teacher's grading. Figures and attachments the agent could not extract stay unchecked and the skill says so, as in the test case with an unextracted figure. To check code and calculations the agent needs access to your files, so do not hand over more than necessary.

How to disable. Delete the `assignment-check` folder from the agent skills directory. The skill leaves no other files.

FAQ

How do I install Assignment Check?

Run `npx skills add https://github.com/henryyu333/assignment-check --skill assignment-check` and add `-g` for a user-level install. You can also copy the `assignment-check` folder by hand.

Is it an AI detector?

No. The skill does not detect authorship, search for plagiarism or grade.

What does the user get?

A list of completed and only mentioned requirements, the problems found and the 1–3 highest value fixes.

What is checked besides text?

Calculations, code, citations and key facts. If something cannot be verified, the skill marks the item as unconfirmed.

Does the skill have tests?

Yes, 20 cases T1–T20 in `evals/`, including a missing requirement, description instead of comparison and prompt injection inside the work.

Discussion

No questions or reviews yet.

Skills

A skill that spots defensive academic prose: pre-emptive replies to reviewers, stacked caveats and excuses for weak results.

SkillMinimal access125

A skill that strips defensive caveats, apologies and excess hedging from text and makes claims direct while keeping needed limits

SkillMinimal access1.9K

A skill for editing academic writing and grant proposals: strips AI-writing tells, keeps the scholarly voice and ties claims to evidence

SkillMinimal access4.6K

A skill that stress-tests a research paper before submission: mocks a review, gives a verdict, helps revise and re-verify

SkillMinimal access1.2K

A skill and methodology that turn scanned learning materials into interactive practice apps: transcription, grading and cost.

SkillMinimal access110

README in short

The skill describes a requirements, evidence, verification method with an example on comparing solar and wind energy. The README is in Chinese and English.

README badge

Original SKILL.md

---
name: assignment-check
description: 作业提交前检查 / assignment preflight checker。用于“检查作业能不能交、提交前再 check、是否符合老师要求、check my assignment before I submit it、review my homework/essay/report/code against the brief or rubric”等场景。把老师要求拆成 requirement ledger，逐条映射到学生证据；能用工具就实际验证，最后按潜在失分影响给出最该先改的 1–3 项。
license: MIT
compatibility: "Requires a host Agent that can read assignment files. Web access is optional for external verification; safe code execution requires a sandboxed host environment."
metadata:
  version: "1.0.2"
---

# Assignment Check

**Check your assignment before you submit it.** 学生提交前检查一份作业，或改完再检查一次。

不用在：代写作业、给正式成绩、判抄袭或 AI 生成率、批量批改班级、与被检查作业无关的写作请求。

机制只有一条：**老师要求 → 学生证据 → 验证结果**，三个角缺一不可。有老师要求时，没找学生证据不下结论；确认读取完整且找不到才判 `MISSING`。没有老师材料时仍可查技术正确性，但不声称"符合要求"、不推导成绩。有证据没独立验证时，正确性结论只能 `REVIEWED ONLY`。

## 状态词（只用这套原词，不另造）

- 要求状态：`MET`（有充分证据完成）· `PARTIAL`（有内容缺一部分）· `MISSING`（已确认读取完整且无对应内容）· `CONTRADICTED`（与要求明确冲突）· `UNVERIFIED`（无法可靠读取/定位/判断）· `NEEDS CLARIFICATION`（老师材料含糊或互相冲突）· `NOT APPLICABLE`。
- 验证状态（按单条 requirement / finding 标，不整份打一个总标签）：`VERIFIED`（工具输出、重算结果、可复核文件证据或可追溯外部来源）· `REVIEWED ONLY`（已读已分析，无独立验证）· `NOT VERIFIED`。两组状态回答不同问题，不混用。
- Finding 来源：`TEACHER REQUIREMENT` / `RUBRIC` / `TECHNICAL CORRECTNESS` / `SUBMISSION INTEGRITY` / `GENERAL ADVICE`。只有前四类进完成率与修改优先级；`GENERAL ADVICE` 单独不足以把状态推到 `NEEDS REVISION`。

## 用户展示层（默认面向学生）

内部继续使用上面的状态、ID 与验证状态；**默认学生报告不要把这些工程词直接倒给用户**。只有用户明确要“完整报告 / requirement ledger / 技术细节”时才显示 `R4`、`MET`、`VERIFIED`、`MATCH UNCERTAIN` 等内部原词。

默认总体状态：
- `READY TO SUBMIT` → **可以提交**
- `NEEDS REVISION` → **建议修改后再提交**
- `CHECK INCOMPLETE` → **还不能确认是否可以提交**

默认检查项统计：
- `MET` → **已完成**
- `PARTIAL` → **部分完成**
- `MISSING` / `CONTRADICTED` → **缺失 / 有冲突**
- `UNVERIFIED` / `NEEDS CLARIFICATION` → **暂时无法确认**

默认验证深度：
- `VERIFIED` → **已核实**
- `REVIEWED ONLY` → **已检查，未独立核实**
- `NOT VERIFIED` → **未核实**

要求 ID、finding ID 与技术状态继续在内部保存，保证复查和完整报告可追踪；默认短报告只写老师要求本身、问题、原因和下一步。复查中的 `MATCH UNCERTAIN` 默认写成 **“暂时无法确认是不是同一个问题”**。

Report a problem