Skip to content

Add context-refactor skill for cross-cutting doc/script audits - #1

Merged
sfalasca merged 1 commit into
masterfrom
worktree-context-refactor-skill
Sep 2, 2026
Merged

sfalasca merged 1 commit into
masterfrom
worktree-context-refactor-skill

Conversation

@sfalasca

@sfalasca sfalasca commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Summary

  • New context-refactor skill: audits directives/how-tos/scripts together for judgment calls no single one can make — section-level type misclassification (a directive with embedded steps that belong in a how-to, or vice versa), directives with no backing enforcement script, wrong hierarchy placement, and duplicate scripts worth generalizing upward.
  • Always interactive on the decision (findings presented one at a time, never batch-applied), mostly inline on the mechanics (background agent only for large multi-file executions).
  • Cross-references added to the three existing skills' SKILL.md files pointing here for cross-cutting cases.
  • README, plugin marketplace metadata, and the npx skills install test updated for the fourth skill.

Test plan

  • python3 -m unittest (frontmatter, help-contract, and skill script tests) — all pass
  • Container-only npx skills add install test (needs Docker/Podman, not run here)

Reviews directives, how-tos, and scripts together for judgment calls
none of them can make alone: section-level type misclassification (a
directive with embedded steps that belong in a how-to, or vice versa),
directives with no backing enforcement script, wrong placement in the
directory hierarchy, and duplicate scripts worth generalizing upward.
Interactive: findings are always presented one at a time for the user
to decide, with mostly-inline apply.

Wires cross-references from the three existing skills' SKILL.md files,
and updates README/plugin metadata/tests for the fourth skill.
@sfalasca
sfalasca marked this pull request as ready for review September 2, 2026 09:02
@sfalasca
sfalasca merged commit 81286a1 into master Sep 2, 2026
7 checks 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.

1 participant