rhaist/marq / .claude/skills/refresh-skills
refresh-skills
VerifiedRuns the 6-8 week review sweep of the skills/ knowledge pack against primary sources, bumps review dates and the pack version, and cuts a local pack release. Use when the user asks to refresh, re-verify or release the skills pack, or when `marq skills --stale` reports overdue skills.
Run the periodic review sweep of the skills/ pack. Today's date is the review date.
-
What's due. Run
go run ./cmd/marq skills --staleand note the list. A full sweep reviews every skill anyway; the list says which ones are overdue. -
Sweep in parallel — spawn two general-purpose agents in one message, each with the date, this repo path, and these rules:
- Directories: agent A
skills/{standards,grc,ciso,enablers,resilience,physical-human}/; agent B every other directory underskills/(list them withls skills/so a new category is never skipped). - Find content outdated as of today: regulatory dates and application status (CRA, NIS2 transposition, DORA, AI Act, GDPR/Digital Omnibus, US state privacy, SEC/CIRCIA/CMMC, NERC CIP, TSA SDs), standard versions (ISO 27001/27002, NIST CSF / SP 800-53, PCI DSS, SOC 2, IEC 62443, CIS Controls, CVSS), ATT&CK and OWASP versions, EPSS/NVD/KEV, tool flags, dead feed/API URLs, and marq tool names that no longer exist in
internal/registry/*.go. - Verify every change against a primary or authoritative source (WebSearch/WebFetch). Never edit from memory. If unverifiable, don't change it — list it.
- Minimal, surgical edits in place; keep frontmatter, style and the agentskills.io rules (name == directory, description 1-1024 chars in third person saying what the skill covers and "Use when ...", double-quote a description containing
:). Don't restructure or add skills. Don't commit. - Report per file: one line per change with the source URL, then the unverified suspects.
- Directories: agent A
-
Review the diff (
git diff skills/) and resolve anything the agents flagged as unverified with the user. -
Bump review dates for every skill the sweep covered, and the pack version:
d=$(date +%F) v=$(date +%Y).$((10#$(date +%m))).$((10#$(date +%d))) # semver: no leading zeros find skills -name SKILL.md -exec sed -i '' "s/^ verified: \".*\"/ verified: \"$d\"/" {} + sed -i '' "s/\"version\": \".*\"/\"version\": \"$v\"/" skills/.claude-plugin/plugin.json(GNU sed: drop the
''after-i.) -
Gates:
go vet ./... && go test ./... && bash scripts/e2e.sh,go run ./cmd/marq skills --stale(expect 0),claude plugin validate . && claude plugin validate ./skills, the official validator (pip install "git+https://github.com/agentskills/agentskills#subdirectory=skills-ref"in a venv, thenskills-ref validateon everyskills/*/*/), andnpx -y skills add ./ --list </dev/nullmust report every skill with nothing skipped. -
Release: commit on a branch (
skills: <month> review sweepwith the per-file change list in the body), merge to main locally, and tagpack-<date>. Leave pushing (commits and tag) to the user.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 468k | Updated | Claude CodeCodex | Unverified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 319k | Updated | Claude CodeCodex | Verified | Install |