{"id":51204718,"url":"https://github.com/kpab/socratic-comprehension","last_synced_at":"2026-06-28T02:33:15.737Z","repository":{"id":365365651,"uuid":"1270770333","full_name":"kpab/socratic-comprehension","owner":"kpab","description":null,"archived":false,"fork":false,"pushed_at":"2026-06-17T02:24:18.000Z","size":10,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-17T04:18:01.505Z","etag":null,"topics":["agent-skills","claude-code","claude-plugin","claude-skill","socratic"],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kpab.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-16T03:17:04.000Z","updated_at":"2026-06-17T02:24:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/kpab/socratic-comprehension","commit_stats":null,"previous_names":["kpab/socratic-comprehension"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kpab/socratic-comprehension","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpab%2Fsocratic-comprehension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpab%2Fsocratic-comprehension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpab%2Fsocratic-comprehension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpab%2Fsocratic-comprehension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kpab","download_url":"https://codeload.github.com/kpab/socratic-comprehension/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kpab%2Fsocratic-comprehension/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34875357,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-skills","claude-code","claude-plugin","claude-skill","socratic"],"created_at":"2026-06-28T02:33:14.252Z","updated_at":"2026-06-28T02:33:15.732Z","avatar_url":"https://github.com/kpab.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# socratic-comprehension\n\nA Socratic sparring-partner Agent Skill that helps you understand a difficult text, paper, or concept **to the point where you can explain it in your own words.**\n\nIt never summarizes or ghost-writes for you. Understanding only happens when you rebuild the logic yourself and put it into words — so this skill withholds the answer, makes you reconstruct, and pushes back sharply on how you phrase it.\n\n## What it does\n\n- **Separates the goal first** — figures out whether you want to *understand* or just want a *deliverable*\n- **Shows the whole shape first** — breaks the target into reasoning steps (nodes) and lays out the path before starting\n- **One node at a time** — prompts \"restate this in your own words\" and never writes the answer first\n- **Names the drifting word** — pinpoints exactly where your wording slipped from the original meaning, not a vague \"a little off\"\n- **Makes you grasp the crux** — has you resolve the underlying premise and central tension yourself\n- **Term test** — checks whether you can define each key term in one sentence without borrowing the original phrasing\n- **Critique layer** — separates \"description\" from \"position-taking\" and draws out your doubts and counterarguments (understanding ≠ agreement)\n\n## When it activates\n\nIt triggers when you ask to understand or internalize something for yourself — e.g. \"what does this mean\", \"I want to understand this myself\", \"help me make this click\", \"I want to organize this for my own use\", \"break this down\". It also fires on the Japanese equivalents (「これどういうこと」「腹落ちさせたい」「噛み砕きたい」など). It does **not** fire when you clearly ask for a deliverable (\"summarize this\", \"write an article\") — instead it confirms your goal once before proceeding.\n\n## Installation\n\nPick whichever fits your setup. For a **personal** install (available in every project), use a global/user-level option.\n\n### Claude Code plugin (marketplace)\n\n```\n/plugin marketplace add kpab/socratic-comprehension\n/plugin install socratic-comprehension\n```\n\n### skills.sh CLI (`npx skills`)\n\nVia the [skills.sh](https://skills.sh) CLI ([vercel-labs/skills](https://github.com/vercel-labs/skills)). No install needed — run it with `npx`.\n\n```\n# Personal (user-level) install — works in every project:\nnpx skills add kpab/socratic-comprehension --global\n\n# Or project-local (installs into the current directory):\nnpx skills add kpab/socratic-comprehension\n```\n\n\u003e **Note:** without `--global`, the CLI installs **project-local** into the directory you run it from (`./.agents/skills/` plus a `.claude/skills/` symlink), *not* into `~/.claude/skills/`. If the skill \"doesn't show up,\" you most likely want `--global`.\n\n### Manual copy\n\nCopy `skills/socratic-comprehension/` into your skills directory:\n\n```\n# Personal:\n~/.claude/skills/socratic-comprehension/\n\n# Project-only:\n\u003cproject\u003e/.claude/skills/socratic-comprehension/\n```\n\n## Structure\n\n```\n.\n├── .claude-plugin/\n│   ├── marketplace.json\n│   └── plugin.json\n└── skills/\n    └── socratic-comprehension/\n        └── SKILL.md\n```\n\n## License\n\nMIT © 2026 kpab\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkpab%2Fsocratic-comprehension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkpab%2Fsocratic-comprehension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkpab%2Fsocratic-comprehension/lists"}