Skip to content

Document both harness paths and any tool - #4

Merged
beelarr merged 3 commits into
mainfrom
cursor/two-harness-paths-0d0c
Oct 6, 2026
Merged

beelarr merged 3 commits into
mainfrom
cursor/two-harness-paths-0d0c

Conversation

@beelarr

@beelarr beelarr commented Oct 6, 2026 •

Copy link
Copy Markdown
Owner

Summary

The README now states the two situations this skill actually handles, and that the files are not tied to one tool.

  • You install socratic in a repository you already have. The skill does not create the repository.
  • Harness instructions are the documentation an agent follows: AGENTS.md, .agents/rules/, and .agents/skills/. The skill writes those files. Cursor, Claude, and Codex remain the harnesses that run them.
  • No harness instructions yet: the skill writes them from what you accept.
  • Harness instructions are already there: the skill reads them, checks manifest changes, and updates a rule, skill, or MCP entry it wrote when you say so. An existing AGENTS.md stays.
  • One copy lives in .agents. Cursor, Claude, Codex, Copilot, and Windsurf are asked by name. Any other tool gets a symlink or a one-line import to that same copy.
  • npx skills update updates the installed skill. Improving the harness instructions is another session.
  • The intro does not say there is no CLI. Installing a skill already says what this is.

Tests

npm test passed.

Open in Web Open in Cursor 

cursoragent and others added 3 commits October 6, 2026 23:01
The README now says the skill runs in a repository you already have, whether or not a harness is there, and that every tool shares the one copy in .agents.

Co-authored-by: Bryon Larrance <beelarr@users.noreply.github.com>
The README already says socratic is a skill you install.

Co-authored-by: Bryon Larrance <beelarr@users.noreply.github.com>
The skill writes instructions for a harness. It is not the harness itself.

Co-authored-by: Bryon Larrance <beelarr@users.noreply.github.com>
@beelarr
beelarr marked this pull request as ready for review October 6, 2026 23:09
@beelarr
beelarr merged commit 1a75331 into main Oct 6, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants