Skip to content

docs(plugin): bring the skill up to date with the rule shape, validate-file and semantic options - #168

Merged
mindsocket merged 2 commits into
mainfrom
plugin-skill-refresh
Oct 16, 2026
Merged

mindsocket merged 2 commits into
mainfrom
plugin-skill-refresh

Conversation

@mindsocket

@mindsocket mindsocket commented Oct 16, 2026 •

Copy link
Copy Markdown
Owner

Brings the Claude Code plugin skill up to date with the stack below it (#159–#166).

  • schema-authoring.md: splits the single rules paragraph into three parts: the expression and semantic parts, the other rule fields, and the semantic options. It adds an example rule that uses scope and includeContent.
  • commands.md: adds a validate-file section, and describes rules, --semantic, trimming and --json as they work now.
  • SKILL.md:
    • Lists validate-file, render, sctx providers and sctx docs semantic-rules.
    • Notes node content, linking to the docs.
    • Replaces troubleshooting messages the CLI no longer prints (File has no type field, could not find node, JSONata error) with the current messages, including (Rule error: …) and (Semantic evaluation error: …).

Verified by loading the example rule into a probe schema with sctx schemas show. A negative control with scope: ["cousins"] is rejected by the metadata contract.

  • AGENTS.md: the definition of done gains a table mapping each kind of change (CLI, rule or schema shape, messages, config, --json output, parsing, terms) to the files to reread, including files the change does not touch.

@mindsocket
mindsocket force-pushed the plugin-skill-refresh branch 2 times, most recently from 681d1dc to e9d6001 Compare October 16, 2026 04:36
@mindsocket
mindsocket added this pull request to stack #167 October 16, 2026 04:37
@mindsocket
mindsocket force-pushed the plugin-skill-refresh branch from e9d6001 to 9d1f2ac Compare October 16, 2026 04:46
@mindsocket
mindsocket marked this pull request as ready for review October 16, 2026 05:31
@claude

claude Bot commented Oct 16, 2026

Copy link
Copy Markdown

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@mindsocket
mindsocket force-pushed the plugin-skill-refresh branch from 9d1f2ac to 18e8d3b Compare October 16, 2026 05:49
@mindsocket
mindsocket force-pushed the plugin-skill-refresh branch 2 times, most recently from 20a811a to 2806d99 Compare October 16, 2026 06:03
@mindsocket
mindsocket force-pushed the plugin-skill-refresh branch from 2806d99 to 2c07882 Compare October 16, 2026 06:14
Base automatically changed from issue-152-trim to main October 16, 2026 06:19
…e-file and semantic options

- schema-authoring: split the rules paragraph into expression/semantic parts, rule fields and
  semantic options, with an example rule using scope and includeContent
- commands: add validate-file; describe rules, --semantic, trimming and --json accurately
- SKILL: list validate-file, render, providers and semantic-rules docs; note node content;
  replace troubleshooting messages that the CLI no longer prints with current ones
@mindsocket
mindsocket force-pushed the plugin-skill-refresh branch from 2c07882 to c9c548a Compare October 16, 2026 06:19
@mindsocket
mindsocket merged commit 5fea8f9 into main Oct 16, 2026
2 checks passed
@mindsocket
mindsocket deleted the plugin-skill-refresh branch October 16, 2026 06:22
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.

1 participant