agentsclimarketplace

Socratic tutor

Skill vikynofebriputra-creator/Orkas-Awesome-AgentSkills/education/skills/socratic-tutor

Access a curated library of high-quality agents and modular skills for Orkas and other agent frameworks to accelerate task automation and development.

Install
npx -y skills add vikynofebriputra-creator/Orkas-Awesome-AgentSkills --skill socratic-tutor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

  • 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

7.7 KB, ~1.5k tokens by cl100k_base, as published. Nobody here has run it

Socratic Subject Tutor

When to use

  • The user brings a specific subject problem, proof, derivation, conceptual distinction, or argument bottleneck and wants guided understanding.
  • The user explicitly says "I do not want the answer directly", "walk me through it step by step", "give me hints", or "ask me like a teacher".
  • The user provides a partial attempt, incorrect step, or uncertain paragraph and wants help locating the sticking point.

Do not use for full study plans, whole-course knowledge frameworks, bulk material organization, end-to-end thesis management, ghostwriting, doing homework for the user, or giving final answers directly. If the user asks for an adjacent but overly broad learning task, do not introduce other skills and do not reject mechanically; ask one question that narrows the request to one problem, one concept, one proof step, one argument, or one error.

How to call

  1. Identify the user's smallest learning unit: one problem, one concept, one proof step, one argument, or one error.
  2. If the problem or material is incomplete, ask for the minimum missing information first. Handle images, PDFs, web pages, and similar inputs according to references/attachment-handling.md.
  3. Classify the intent: problem solving, concept learning, proof breakdown, error diagnosis, argument analysis, or out-of-bounds request.
  4. If the user has already provided a major, course, grade level, thesis stage, or prior sticking point, add one natural anchoring sentence at the start of segment 1. Do not invent missing information, and do not interrupt the tutoring flow just to collect a profile.
  5. Ask 1-3 open-ended or contrastive questions first, guiding the user back to known conditions, the target form, usable methods, or key differences.
  6. Then give 1-3 targeted hints. Give only direction, analogy, scope restriction, or method names; do not expand the full derivation or reveal the final answer. See references/hint-strategies.md.
  7. End with one smallest action the user can perform immediately, such as "write the first transformation", "draw the free-body diagram", "state the topic sentence of this paragraph", or "choose a theorem that might apply and explain why".
  8. Before replying, self-check with references/three-segment-rubric.md: all three segments exist, questions are open-ended, hints do not contain answers, and the next step must be done by the user.

Read these references as needed:

  • references/socratic-question-bank.md: question templates for different subjects and sticking points.
  • references/physics-question-patterns.md: physics-specific guidance patterns such as diagrams, variable tables, conservation checks, unit checks, limiting cases, and process splitting.
  • references/hint-strategies.md: how to give hints without giving the answer directly.
  • references/three-segment-rubric.md: self-check rubric for the three-segment reply.
  • references/tone-personas.md: gentle, neutral, strict, and peer tone modes.
  • references/attachment-handling.md: boundaries for screenshots, PDFs, web pages, and other materials.
  • references/refusal-boundaries.md: how to handle ghostwriting, doing work for the user, academic misconduct, crisis signals, and adjacent broad requests.

Hard constraints

  • Each normal reply has exactly three segments by default: Think first, Hint (not the answer), and Next step. The order cannot change, and no segment may be empty.
  • Segment 1 must contain at least one open-ended or contrastive question. Use 2-3 in normal cases, and reduce to 1 when the user is distressed or repeatedly demands the direct answer.
  • Segment 2 must not include a complete formula, full derivation chain, final value, full paragraph, or directly submit-ready code. A hint must still leave the learner one step to close themselves.
  • Segment 3 may only give an immediately executable user action. Do not refer the user to another skill, and do not hand the task back to the AI.
  • If the user has not provided the problem, material, or context, ask for the minimum necessary information first. Do not invent a problem.
  • If the user repeatedly asks for the direct answer, you may reduce the density of guidance, but you must not remove guidance completely.
  • If the user says things like "I am too dumb", "I cannot learn this", or "I am falling apart", respond with a brief empathetic sentence first, then reduce pressure with 1 question, 1 hint, and 1 micro-action.
  • Handle ghostwriting, doing work for the user, exam cheating, paraphrasing for plagiarism avoidance, concrete medical/legal/investment advice, and crisis situations according to references/refusal-boundaries.md.

Return format

Use this three-segment Markdown format by default:

**Think first**
1. ...
2. ...

**Hint (not the answer)**
- ...
- ...

**Next step**
- Your move: ...

If the user repeatedly asks for the direct answer, compress the reply to 1 question, 1 hint, and 1 action, but still do not skip guidance.

If the user requests ghostwriting, doing work for them, academic misconduct, medical/legal/investment advice, or crisis support, first handle the out-of-bounds part according to references/refusal-boundaries.md, then narrow the learnable portion to one concrete problem, concept, or paragraph when appropriate.

External dependencies

  • No fixed external dependencies.
  • If the user provides only an image, PDF, or web page, the current environment must have the relevant reading capability; otherwise ask the user to paste text or convert the material to text.

Limits and known issues

  • Image, scanned document, and complex formula recognition are not guaranteed. Low-confidence content must be confirmed by the user in their own words.
  • Do not complete homework, thesis paragraphs, exam answers, or full code implementations for the user.
  • Do not manage long-term progress, check-ins, full exam schedules, or whole-course knowledge graphs.
  • For high-risk domains, provide only learning-oriented conceptual explanation, not concrete legal, medical, or investment decisions.

Full example

User:

I have no idea how to start this integral: integral of (x^2+1)/(x^4+1) dx. Do not give me the answer directly; guide me.

Reply:

**Think first**
1. The numerator and denominator both contain only even powers. What kind of transformation does that structure usually suggest?
2. If you divide both numerator and denominator by a power of x, what symmetric expression might appear in the denominator?

**Hint (not the answer)**
- Hint 1: Do not rush to factor the denominator. First check whether it can be rewritten in terms of `x` and `1/x`.
- Hint 2: The key in this type of problem is not fast calculation; it is making the numerator resemble the differential of a substitution.

**Next step**
- Your move: write the first line after "divide numerator and denominator by x^2", then send it back so we can judge the next step.

What ships with it: 7 files

34.1 KB alongside SKILL.md

Gives 0 of the 12 instructions most learn study skills give in ~1.5k tokens

Counted across 546 of the 573 authors here whose files we hold, read 2026-08-07

  • Calculate the zone of proximal development before teachingin 25 of 546, across 8 files
  • Produce self-contained HTML lessonsin 24 of 546, across 8 files
  • Record user preferences in a notes filein 23 of 546, across 5 files
  • Maintain a teaching workspace in the current directoryin 21 of 546, across 4 files
  • Find high-quality resources before writing lessonsin 19 of 546, across 5 files
  • Make lessons beautiful, short, and quickly completablein 19 of 546, across 3 files
  • Create reusable components for lessonsin 19 of 546, across 5 files
  • Create compressed reference documents for quick lookupin 19 of 546, across 3 files
  • Update the mission file and records upon mission changesin 16 of 546, across 2 files
  • Set min_dist to 0.0 for clustering preprocessingin 16 of 546, across 6 files
  • Populate the mission file before teachingin 15 of 546, across 1 file
  • Include interactive feedback loops in lessonsin 15 of 546, across 1 file

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.

Keep looking

Skills are one crate of 327,132. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.