alexago83/logics-doc-linter
logics-doc-linter/SKILL.md
Lint and validate the Logics Markdown conventions. Use when Codex should verify filenames, top headings, and required indicators across `logics/request`, `logics/backlog`, `logics/tasks`, `logics/product`, and `logics/architecture`, and report inconsistencies.
development
Updated Apr 24, 2026
$ install --global
skillsauthnpx skillsauth add alexago83/cdx-logics-kit logics-doc-linterInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 24, 2026, 10:07 AM26.4s3 files scanned
SKILL.md
- name:
- logics-doc-linter
- description:
- Lint and validate the Logics Markdown conventions. Use when Codex should verify filenames, top headings, and required indicators across `logics/request`, `logics/backlog`, `logics/tasks`, `logics/product`, and `logics/architecture`, and report inconsistencies.
Lint Logics docs
Run
python logics/skills/logics-doc-linter/scripts/logics_lint.py
python logics/skills/logics-doc-linter/scripts/logics_lint.py --require-status
What it checks
- Filename patterns (
req_###_*.md,item_###_*.md,task_###_*.md,prod_###_*.md,adr_###_*.md). - First heading format:
## <doc_ref> - <Title>. - Required indicators:
- requests:
From version,Understanding,Confidence - backlog/tasks: plus
Progress
- requests:
- product briefs:
Date,Status, related refs,Reminder - architecture docs:
Date,Status,Drivers, related refs,Reminder Statusvalue validation when present using the allowed values for each doc family.- Optional strict mode (
--require-status) to enforceStatuson every supported doc type. - For modified or untracked workflow docs (
request,backlog,task):- blocking errors for critical indicator placeholders such as
X.X.Xand??% - warning-level reporting for leftover template filler text such as
Describe the needorAdd context and constraints - warning-level reporting for generic Mermaid scaffolds or missing/stale
%% logics-signaturecomments in workflow Mermaid blocks - if a doc edit is explicitly non-semantic, add a marker such as
> Maintenance edit:or> Non-semantic edit:in the doc so the linter can keep indicators stable without guessing intent
- blocking errors for critical indicator placeholders such as
Related Skills
alexago83/logics-mermaid-generator
data-ai
VerifiedTrustedCommunity
Generate Logics workflow Mermaid blocks with a deterministic fallback that stays compatible with the flow manager.
1SKILL.mdUpdated Apr 10, 2026
alexago83/fixture-valid-skill
testing
VerifiedTrustedCommunity
Fixture skill used to validate Logics kit package parsing.
1SKILL.mdUpdated Apr 2, 2026
alexago83/tests/fixtures/skill_package_invalid
testing
VerifiedTrustedCommunity
--- name: fixture-invalid-skill description: invalid: yaml frontmatter sample --- # Fixture Invalid Skill This fixture intentionally violates the SKILL frontmatter contract.
1SKILL.mdUpdated Apr 2, 2026
alexago83/logics-workstream-planner
development
VerifiedTrustedCommunity
Plan workstreams/roadmap from Logics backlog and tasks. Use when Codex should generate a `logics/ROADMAP.md` grouping items into Now/Next/Later/Done based on priority and progress.
1SKILL.mdUpdated Apr 2, 2026