HN 표시: Slop Cop Claude 코드/커서 플러그인

A Go CLI that detects the rhetorical and structural tells of LLM-generated prose and emits a structured JSON report. Designed for automated agent consumption, not humans. No TUI, no highlighting, no interactive prompts. Ships with a plug-and-play skill for Claude Code and Cursor: the agent runs slop-cop on its own prose drafts and silently revises before replying. The binary auto-installs on first use, so Go is not required. Most people will use slop-cop through their coding agent. The skill activates whenever you ask the agent to write, edit, or polish prose (blog posts, docs, PR descriptions, commit messages, release notes, emails). /plugin marketplace add yasyf/slop-cop /plugin install slop-cop@slop-cop Open the Plugins panel and install from Git URL: https://github.com/yasyf/slop-cop . On the first draft the skill sees, it runs scripts/install-binary.sh (or .ps1 on Windows) which downloads the right prebuilt binary for your platform from the rolling latest GitHub Release and drops it into the plugin directory. Subsequent runs reuse the cached binary. No Go toolchain required. Verify end-to-end with scripts/test-plugin.sh , which spawns a claude -p subshell with --plugin-dir pointed at a local checkout and asserts the skill activated. Given any prose the agent is about to return, the skill: - Resolves (or auto-downloads) the slop-cop binary inside the plugin. - Pipes the draft through slop-cop check - , getting back a JSON list of violations across 48 rules: overused intensifiers, filler adverbs, em-dash abuse, negation pivots, metaphor crutches, throat-clearing, hedge stacks, and more. - Revises and re-runs until the report is clean. - Returns the revised draft to you, without narrating the process. See skills/slop-cop-prose/SKILL.md for the exact instructions the agent receives. The plugin is the primary UI. If you want to invoke slop-cop directly from scripts, CI, pre-commit hooks, or another tool, install the binary: # Prebuilt binary matching your platform curl -fsSL "https://github.com/yasyf/slop-cop/releases/download/latest/slop-cop_$(uname -s | tr A-Z a-z)_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" \ | tar -xz -C /tmp && sudo mv /tmp/slop-cop_*/slop-cop /usr/local/bin/ # Or from source go install github.com/yasyf/slop-cop/cmd/slop-cop@latest The --llm / --llm-deep and rewrite modes additionally require the claude CLI on $PATH ; slop-cop never needs an Anthropic API key of its own because claude -p uses your Claude subscription. slop-cop [command] Commands: check [path|-] Run detectors; emit JSON report. rewrite [path|-] Rewrite a paragraph via `claude -p`. rules Print the full rule catalogue as JSON. version Print build metadata as JSON. Exit codes: 0 success (including "no violations found") 2 input/IO error 3 claude subprocess error 4 flag/usage error Input is the positional argument (- or omitted for stdin). Output is JSON on stdout; diagnostics go to stderr. # File input slop-cop check article.md # Stdin cat article.md | slop-cop check # With Claude-backed semantic + document passes slop-cop check article.md --llm --llm-deep --pretty Example output (trimmed): { "text_length": 135, "violations": [ { "ruleId": "era-opener", "startIndex": 0, "endIndex": 12, "matchedText": "In an era of" }, { "ruleId": "important-to-note", "startIndex": 27, "endIndex": 50, "matchedText": "it is important to note" } ], "counts_by_rule": { "era-opener": 1, "important-to-note": 1 }, "counts_by_category": { "rhetorical": 1, "word-choice": 1 } } Flags: | Flag | Default | Purpose | |---|---|---| --markdown | auto | auto|on|off . Auto enables markdown mode for .md / .markdown / .mdx . | --llm | auto (on under plugin) | Sentence-tier semantic pass (Claude Haiku). Auto-enabled when $CLAUDE_PLUGIN_ROOT or $CURSOR_PLUGIN_ROOT is set AND the claude CLI is on $PATH ; pass --llm=false to opt out. | --llm-deep | auto (on under plugin) | Document-tier structural pass (Claude Sonnet). Same auto-default as --llm . | --claude-bin | claude | Path to the claude CLI | --sentence-model | claude-haiku-4-5-20251001 | Model slug for --llm | --document-model | claude-sonnet-4-6 | Model slug for --llm-deep | --sentence-timeout | 30s | Timeout per sentence-pass chunk | --document-timeout | 60s | Timeout for the document pass | --pretty | off | Indent JSON output | When active (auto-detected on .md / .markdown / .mdx , or forced via --markdown=on ), slop-cop check : - Masks non-prose bytes before running detectors: fenced + indented code blocks, inline code spans, link/image destinations, autolinks, reference-definition lines, inline + block HTML, YAML front matter. Detectors see ASCII spaces where these appeared, so utilize inside a`code` span or a URL no longer fireselevated-register . - Suppresses two structural false positives via the parsed markdown AST: dramatic-fragment on ATX/setext headings, andstaccato-burst that spans two or more consecutive list items (a bulleted list is not prose cadence). - Preserves byte offsets. Violations still carry startIndex /endIndex into the original input, andmatchedText is re-sliced from the original bytes. Consumers don't see the masking at all; they see an accurate, cleaner report. Masking is a length-preserving, newline-preserving transform, so nothing else in the pipeline changes. Use --markdown=off on a .md file when you want to see every markdown-structure hit. Runs the rewriteParagraph flow from the original source: builds a system prompt from the default rewrite directives (plus any rule IDs you pass) and asks Claude to rewrite the input. slop-cop rewrite draft.txt --rules filler-adverbs,hedge-stack --pretty Output: { "rewritten": "…", "applied_rules": ["filler-adverbs", "hedge-stack"] } Dumps rule metadata so agents don't have to hard-code it. slop-cop rules --llm-only --pretty slop-cop rules --category word-choice type Violation = { ruleId: string // stable rule identifier (see `slop-cop rules`) startIndex: number // byte offset into the UTF-8 input, inclusive endIndex: number // byte offset, exclusive matchedText: string // text[startIndex:endIndex] explanation?: string // optional extra context (LLM passes, and a few // client-side detectors like hedge-stack set this) suggestedChange?: string // LLM-supplied replacement, "" to suggest deletion } Byte offsets. Offsets are bytes into the UTF-8 input, not UTF-16 code units as in the original JavaScript. Go's regexp and strings packages work in bytes by default, so consumers doing text[v.StartIndex:v.EndIndex] in Go (or any language that indexes strings by bytes) will get the right substring. If you're slicing the original string in a language that indexes by code units (JavaScript, Java), account for the difference around non-ASCII characters. Client-side (instant). 35 regex + structural detectors. No external calls. These run unconditionally on check . --llm (sentence-tier). Shells out to claude -p --output-format json --json-schema ... with Claude Haiku. Large inputs are chunked at paragraph boundaries (4000-char threshold, 3500-char target) and analysed in parallel, then merged and deduplicated by ruleId + matchedText . 10 rules: triple-construction , throat-clearing , sycophantic-frame , balanced-take , unnecessary-elaboration , empathy-performance , pivot-paragraph , grandiose-stakes , historical-analogy , false-vulnerability . --llm-deep (document-tier). Shells out to Claude Sonnet. 3 rules: dead-metaphor , one-point-dilution , fractal-summaries . When slop-cop check detects it is running inside a Claude Code or Cursor plugin (either $CLAUDE_PLUGIN_ROOT or $CURSOR_PLUGIN_ROOT is set) and the claude CLI is reachable on $PATH , both LLM passes are auto-enabled. The llm field in the JSON report tells you what actually ran: "llm": { "sentence": { "auto": true, "ran": true }, "document": { "auto": true, "ran": false, "error": "claude: exit status 1: …" } } Auto-enabled passes degrade gracefully: if claude isn't reachable or returns an error (missing auth, rate limit, timeout), the failure is captured in the error field and the client-side detectors still return their results. An explicit --llm=true still propagates errors as exit code 3. Pass --llm=false / --llm-deep=false to force the passes off under a plugin. 48 total: 35 client-side, 10 sentence-tier (LLM), 3 document-tier (LLM). See the upstream README for the full pattern list, or run slop-cop rules --pretty locally. - Go CLI + plugin/skill for coding agents instead of a browser UI; no editor, no URL hash sync, no contenteditable. - LLM calls go through the claude CLI (subscription auth) instead of direct Anthropic API requests. - Offsets are UTF-8 byte indices, not JavaScript UTF-16 units. detectNegationPivot reimplements the two-sentence backreference case by hand because Go'sregexp (RE2) has no\2 . All other detection logic is a 1:1 port; the 201 subtests in internal/detectors/word_patterns_test.go mirror the original Vitest suite. .claude-plugin/ Claude Code plugin + marketplace manifests .cursor-plugin/ Cursor plugin manifest skills/slop-cop-prose/ The prose-writing skill agents activate commands/ /slop-cop-check slash command scripts/ install-binary.sh First-run binary bootstrap for the plugin (bash) install-binary.ps1 Same, for Windows (PowerShell) test-plugin.sh Local end-to-end plugin test via `claude -p` cmd/slop-cop/ CLI entry point internal/ Detectors, rules, types, LLM subprocess wrapper main is the release. Every push to main triggers release.yml, which cross-compiles for linux/darwin/windows/freebsd × amd64/arm64 and publishes an immutable v0.1. GitHub Release. is GitHub Actions' monotonic workflow counter, so versions climb 0.1.7, 0.1.8, 0.1.9, … automatically. GitHub marks the newest release as "Latest". Stable install URL (no pinning required): https://github.com/yasyf/slop-cop/releases/latest/download/slop-cop__.tar.gz To pin to a specific build, use the tag directly: go install github.com/yasyf/slop-cop/cmd/[email protected] or the versioned asset URL: https://github.com/yasyf/slop-cop/releases/download/v0.1.7/slop-cop__.tar.gz slop-cop version reports the matching 0.1. string baked in at build time. The repo pins Go 1.26.2 via .tool-versions . With asdf installed, run asdf install in the repo root to pick it up; otherwise install Go 1.26 manually. go test ./... go vet ./... go build ./... The Go source in this repository (the CLI, plugin manifests, skill authoring, subprocess plumbing, build system, documentation, tests) is released under the MIT License. The pattern taxonomy, rule catalogue, detector algorithms, word lists, and LLM prompts are derived from awnist/slop-cop by @awnist. At the time this port was made, that upstream repository carried no open-source licence; see NOTICE for the full provenance, attribution, and compliance guidance. If you plan to use this tool beyond personal use or contributions back to the upstream author, please reach out to @awnist to clarify licensing of the derived content. Original source rules: LLM_PROSE_TELLS.md (MIT, © sneak), Wikipedia: Signs of AI Writing (CC BY-SA 4.0), tropes.md.