Repository navigation
feat: compile the agentic workflow skill library (13 skills) - #3
Merged
Merged
Conversation
Changes the repo's goal from a scanner to the agentic-AI work standard: the deterministic engine stays (569 rules, 9 domains) and the reference corpus is now compiled into a portable workflow skill library that the engine keeps honest. Adds 13 agentic-* skills, one decision each, with sibling boundaries and corpus citations: frame, plan, delegate, context, verify, debug, review, git, secure, memory, skill, harness, loops. Compiled from the corpus's own workflow material (superpowers, agent-skills, agent-skills-for-context-engineering, anthropics-skills, the agentskills spec, DevOps-Security-Agent-Skills, fast-agent, hermes-agent-self-evolution, obsidian-skills); every non-obvious claim cites a corpus path, thin sources are reported instead of padded, and every file gates at 0 errors. Fixes the citation layer: 23 owner/repo citation forms did not resolve on disk because the corpus is cloned flat; scripts/fix-citations.mjs maps them through scripts/reference-corpus.json and normalizes the bare tail form, leaving 112 two-segment citations with 0 unresolved. Adds scripts/check-workflow-library.mjs (name, frontmatter, required sections, description uniqueness, cross-skill sentence duplication). Corrects the install story: the README's npx line named the unscoped zero-slop package, which belongs to another project; every command now names @zero-slop/cli, the README states the CLI is unpublished with the clone path to run today, the npm badge is dropped until the package exists, and a root pnpm build script is added. The skills install from this repo today. Docs: README, MULTI_AGENT_SKILLS, SHIP_PLAN (M1.8), ZERO_SLOP_FRAMEWORK (goal and 84-repo evidence base), package.json description, and the zero-slop router now routes both families. Gates: 23 packs, skills/ 0 errors, docs/ 0 errors, whole repo 0 errors, 614 core + 12 CLI tests, validate:rules healthy, gitleaks and trufflehog clean.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Changes the repo's goal from a scanner to the agentic-AI work standard: the deterministic engine stays (569 rules, 9 domains) and the reference corpus is now compiled into a portable workflow skill library that the engine keeps honest.
The workflow library: 13
agentic-*skillsEach skill owns exactly one decision, names the sibling to use instead, cites the corpus path behind every non-obvious claim, and passes the repo's own scanner at 0 errors.
agentic-frameagentic-plan)agentic-planagentic-verify)agentic-delegateagentic-loops)agentic-contextagentic-memory)agentic-verifyagentic-debug)agentic-debugagentic-reviewagentic-git)agentic-gitagentic-secureagentic-memoryagentic-context)agentic-skillslop-audit-skill)agentic-harnessagentic-loopsagentic-delegate)Compiled from the corpus's own workflow material:
superpowers(15 skills),agent-skills(25),agent-skills-for-context-engineering(24),anthropics-skills,agentskillsspec,DevOps-Security-Agent-Skills,fast-agent,hermes-agent-self-evolution,obsidian-skills. The corpus ships 60+ overlapping workflow skills; the library is the compiled, non-overlapping subset, with each source's prescriptions distilled rather than copied and the thin spots reported instead of padded.The audit family (
slop-audit*, 10 packs) is unchanged in intent: it judges a finished artifact against the rules DB, whileagentic-*governs the work before the artifact exists. Thezero-sloprouter now routes both families.Citation layer fix
The corpus is cloned flat as
reference/<manifest-name>/, but the packs cited 23 owner/repo forms that do not resolve on disk (reference/obra/superpowers:...,reference/jakubkrehel/skills:...) plus bare tail citations after a;separator.scripts/fix-citations.mjsmaps every citation throughscripts/reference-corpus.json(owner/repo to manifest name) and normalizes the tail form. Result: 112 two-segment citations, 0 unresolved, with each tail verified against the corpus path. The script stays next tosync-reference.mjsbecause the corpus refreshes.Install truth
npx -y zero-slop@latest scan .. The unscopedzero-slopname on npm belongs to another project (manavmishra/ZeroSlop), so that command executed a stranger's package. Every install command in the README,docs/PUBLIC_ADOPTION.md,docs/SHIP_PLAN.mdand thezero-sloprouter now names@zero-slop/cli, and the README states the CLI is not published yet with the clone path to run today.pnpm build(core then CLI), which is what the clone instructions use..github/workflows/publish.ymlon av*tag.npx skills use trefeon/zero-slop@slop-auditfetched the pack from the public repo and rendered itsSKILL.md.Docs
README (new tagline, install, workflow-library table),
docs/MULTI_AGENT_SKILLS.md(two families, tree),docs/SHIP_PLAN.md(M1.8 checklist, state line, the fixed ship-acceptance command),docs/ZERO_SLOP_FRAMEWORK.md(goal, 84-repo evidence base, M1.8 milestone), rootpackage.jsondescription.Verification
gate skills/covers the whole tree;gate docs/andgate README.mdalso 0 errors.pnpm validate:ruleshealthy,pnpm typecheckclean, core and CLI test suites pass.Not in this PR
npm publish (needs npm auth or trusted-publisher setup), the GitHub Action, the MCP server.