From aaaf6dd70a79be38bcbae49bb143be2a74c60c7f Mon Sep 17 00:00:00 2001 From: Martin Zeman Date: Thu, 14 May 2026 22:52:09 +0200 Subject: [PATCH 1/2] refactor: drop SKILL.yaml sidecars The sidecar pattern carried Obsidian-style metadata (aliases, keywords, related) parallel to SKILL.md. We no longer use it; the canonical SKILL.md frontmatter is the source of truth for skill metadata. --- skills/AuditScripts/SKILL.yaml | 21 --------------------- skills/BashDevelopment/SKILL.yaml | 19 ------------------- skills/CodeCleanup/SKILL.yaml | 1 - skills/DefensiveProgramming/SKILL.yaml | 14 -------------- skills/FixIssue/SKILL.yaml | 10 ---------- skills/GitHubCLI/SKILL.yaml | 3 --- skills/ReceiveReview/SKILL.yaml | 2 -- skills/RustDevelopment/SKILL.yaml | 15 --------------- skills/SystematicDebug/SKILL.yaml | 2 -- skills/TestDrivenDevelopment/SKILL.yaml | 14 -------------- 10 files changed, 101 deletions(-) delete mode 100644 skills/AuditScripts/SKILL.yaml delete mode 100644 skills/BashDevelopment/SKILL.yaml delete mode 100644 skills/CodeCleanup/SKILL.yaml delete mode 100644 skills/DefensiveProgramming/SKILL.yaml delete mode 100644 skills/FixIssue/SKILL.yaml delete mode 100644 skills/GitHubCLI/SKILL.yaml delete mode 100644 skills/ReceiveReview/SKILL.yaml delete mode 100644 skills/RustDevelopment/SKILL.yaml delete mode 100644 skills/SystematicDebug/SKILL.yaml delete mode 100644 skills/TestDrivenDevelopment/SKILL.yaml diff --git a/skills/AuditScripts/SKILL.yaml b/skills/AuditScripts/SKILL.yaml deleted file mode 100644 index 1ef9f1e..0000000 --- a/skills/AuditScripts/SKILL.yaml +++ /dev/null @@ -1,21 +0,0 @@ -sources: - - https://github.com/N4M3Z/check-mac - - https://github.com/N4M3Z/check-mac/blob/main/docs/decisions/ARCH-0002%20Nagios%20Return%20Codes.md - - https://github.com/N4M3Z/check-mac/blob/main/docs/decisions/ARCH-0003%20Handle%20Managed%20Devices.md - - https://nagios-plugins.org/doc/guidelines.html - -title: Audit Scripts -aliases: [HealthChecks, NagiosChecks, CheckScripts] -tags: [audit, security, health-check, nagios, language-agnostic, forge-dev] -keywords: - - "[[Health Check]]" - - "[[Audit]]" - - "[[Nagios]]" - - "[[macOS Security]]" -collection: "[[Skills]]" -created: 2026-04-26 -updated: 2026-04-26 -related: - - "[[BashDevelopment]]" - - "[[DefensiveProgramming]]" - - "[[CodeCleanup]]" diff --git a/skills/BashDevelopment/SKILL.yaml b/skills/BashDevelopment/SKILL.yaml deleted file mode 100644 index 383a0b7..0000000 --- a/skills/BashDevelopment/SKILL.yaml +++ /dev/null @@ -1,19 +0,0 @@ -sources: - - https://github.com/N4M3Z/check-mac - - https://www.shellcheck.net/ - - https://mywiki.wooledge.org/BashGuide - -title: Bash Development -aliases: [BashConventions, ShellPatterns, ForgeShell] -tags: [bash, shell, posix, scripting, forge-dev] -keywords: - - "[[Bash]]" - - "[[Shell Scripting]]" - - "[[POSIX]]" -collection: "[[Skills]]" -created: 2026-04-26 -updated: 2026-04-26 -related: - - "[[AuditScripts]]" - - "[[DefensiveProgramming]]" - - "[[CodeCleanup]]" diff --git a/skills/CodeCleanup/SKILL.yaml b/skills/CodeCleanup/SKILL.yaml deleted file mode 100644 index b877074..0000000 --- a/skills/CodeCleanup/SKILL.yaml +++ /dev/null @@ -1 +0,0 @@ -sources: [] diff --git a/skills/DefensiveProgramming/SKILL.yaml b/skills/DefensiveProgramming/SKILL.yaml deleted file mode 100644 index 44c193d..0000000 --- a/skills/DefensiveProgramming/SKILL.yaml +++ /dev/null @@ -1,14 +0,0 @@ -sources: [] - -title: Defensive Programming -aliases: [DefensiveCoding, RobustCoding] -tags: [engineering, principles, quality] -keywords: - - "[[Software Engineering]]" - - "[[Error Handling]]" -collection: "[[Skills]]" -created: 2026-02-18 -updated: 2026-02-18 -related: - - "[[RustDevelopment]]" - - "[[TestDrivenDevelopment]]" diff --git a/skills/FixIssue/SKILL.yaml b/skills/FixIssue/SKILL.yaml deleted file mode 100644 index 1059f9c..0000000 --- a/skills/FixIssue/SKILL.yaml +++ /dev/null @@ -1,10 +0,0 @@ -sources: - - https://cli.github.com/manual/gh_issue - - https://cli.github.com/manual/gh_issue_develop - - https://cli.github.com/manual/gh_pr_create - - https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue - - https://gitlab.com/gitlab-org/cli/-/blob/main/docs/source/issue/index.md - - https://gitlab.com/gitlab-org/cli/-/blob/main/docs/source/mr/index.md - -claude: - argument-hint: "[owner/repo#N or issue URL]" diff --git a/skills/GitHubCLI/SKILL.yaml b/skills/GitHubCLI/SKILL.yaml deleted file mode 100644 index cda0339..0000000 --- a/skills/GitHubCLI/SKILL.yaml +++ /dev/null @@ -1,3 +0,0 @@ -sources: - - https://cli.github.com/manual/ - - https://docs.github.com/en/rest diff --git a/skills/ReceiveReview/SKILL.yaml b/skills/ReceiveReview/SKILL.yaml deleted file mode 100644 index bb96f0f..0000000 --- a/skills/ReceiveReview/SKILL.yaml +++ /dev/null @@ -1,2 +0,0 @@ -sources: - - https://github.com/obra/superpowers diff --git a/skills/RustDevelopment/SKILL.yaml b/skills/RustDevelopment/SKILL.yaml deleted file mode 100644 index 6fa89ab..0000000 --- a/skills/RustDevelopment/SKILL.yaml +++ /dev/null @@ -1,15 +0,0 @@ -sources: [] - -title: Rust Development -aliases: [RustConventions, ForgeRust] -tags: [rust, development, forge-core] -keywords: - - "[[Forge Framework]]" - - "[[Rust]]" -collection: "[[Skills]]" -created: 2026-02-18 -updated: 2026-02-18 -related: - - "[[ModuleArchitect]]" - - "[[DefensiveProgramming]]" - - "[[TestDrivenDevelopment]]" diff --git a/skills/SystematicDebug/SKILL.yaml b/skills/SystematicDebug/SKILL.yaml deleted file mode 100644 index bb96f0f..0000000 --- a/skills/SystematicDebug/SKILL.yaml +++ /dev/null @@ -1,2 +0,0 @@ -sources: - - https://github.com/obra/superpowers diff --git a/skills/TestDrivenDevelopment/SKILL.yaml b/skills/TestDrivenDevelopment/SKILL.yaml deleted file mode 100644 index 452bb35..0000000 --- a/skills/TestDrivenDevelopment/SKILL.yaml +++ /dev/null @@ -1,14 +0,0 @@ -sources: [] - -title: Test-Driven Development -aliases: [TDD, TestFirst] -tags: [engineering, principles, testing] -keywords: - - "[[Software Engineering]]" - - "[[Testing]]" -collection: "[[Skills]]" -created: 2026-02-18 -updated: 2026-02-18 -related: - - "[[RustDevelopment]]" - - "[[DefensiveProgramming]]" From bc9ee553beae718a4c7facf0d538507eae2d2142 Mon Sep 17 00:00:00 2001 From: Martin Zeman Date: Thu, 14 May 2026 22:54:46 +0200 Subject: [PATCH 2/2] refactor: rename AuditScripts skill to HealthChecks The skill defines a health-check program architecture (Nagios-style severity ladder with UNKNOWN, key:value output, orchestrator dispatch). HealthChecks frames the contract by what it produces rather than the implementation language, and aligns with industry terminology. The BashDevelopment cross-reference is updated to match. --- skills/BashDevelopment/SKILL.md | 2 +- skills/{AuditScripts => HealthChecks}/SKILL.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) rename skills/{AuditScripts => HealthChecks}/SKILL.md (90%) diff --git a/skills/BashDevelopment/SKILL.md b/skills/BashDevelopment/SKILL.md index 0f144d2..6cf0fbe 100644 --- a/skills/BashDevelopment/SKILL.md +++ b/skills/BashDevelopment/SKILL.md @@ -8,7 +8,7 @@ description: "Bash and POSIX shell conventions for the forge ecosystem — idiom Conventions for writing bash and POSIX shell scripts in the forge ecosystem and adjacent personal projects. Reference implementation lives in [check-mac][CHECKMAC] and the build hooks under forge-core. -For audit-script architecture (severity ladders, key:value output, orchestrator dispatch), see the companion skill [AuditScripts](../AuditScripts/SKILL.md). +For health-check architecture (severity ladders, key:value output, orchestrator dispatch), see the companion skill [HealthChecks](../HealthChecks/SKILL.md). ## Idioms diff --git a/skills/AuditScripts/SKILL.md b/skills/HealthChecks/SKILL.md similarity index 90% rename from skills/AuditScripts/SKILL.md rename to skills/HealthChecks/SKILL.md index 0cb6001..ec8377c 100644 --- a/skills/AuditScripts/SKILL.md +++ b/skills/HealthChecks/SKILL.md @@ -1,12 +1,12 @@ --- -name: AuditScripts +name: HealthChecks version: 0.1.0 -description: "Architecture for security and health audit scripts: standalone-runnable checks, severity ladder with UNKNOWN, key:value output contract, orchestrator dispatch, exit-code semantics. Language-agnostic; reference implementations in Bash, applies to Python and other languages. USE WHEN writing audit tools, designing check-script contracts, adding checks to tools like check-mac, reviewing audit-script architecture, or porting an audit tool between languages." +description: "Architecture for security and health-check programs: standalone-runnable checks, severity ladder with UNKNOWN, key:value output contract, orchestrator dispatch, exit-code semantics. Language-agnostic; reference implementations in Bash, applies to Python and other languages. USE WHEN writing health checks or audit tools, designing check-script contracts, adding checks to tools like check-mac, reviewing health-check architecture, or porting a check tool between languages." --- -# AuditScripts +# HealthChecks -A contract for writing security and health audit scripts. The same contract works in Bash, Python, or any other language that can write structured output to stdout. Reference implementation: [check-mac][CHECKMAC] (Bash). For shell-specific idioms, see the companion skill [BashDevelopment](../BashDevelopment/SKILL.md). +A contract for writing security and health-check programs. The same contract works in Bash, Python, or any other language that can write structured output to stdout. Reference implementation: [check-mac][CHECKMAC] (Bash). For shell-specific idioms, see the companion skill [BashDevelopment](../BashDevelopment/SKILL.md). The architecture has three load-bearing pieces: