Generate semantic code comments with Index blocks and wikilink anchors.
npx skills add https://github.com/joshka0/foxctl --skill semantic-commenting
Please help me install this Agent Skill. Skill: semantic-commenting Source: https://github.com/joshka0/foxctl/tree/main/configs/skills-pack/semantic-commenting Command: npx skills add https://github.com/joshka0/foxctl --skill semantic-commenting
This Skill helps you write semantic code comments that future agents can reliably retrieve and use to understand, navigate, and validate important behavior in a codebase.
Use semantic-commenting to add Index metadata and high-value [[type:slug]] anchors near the code boundary that enforces a specific protocol or safety invariant, then validate anchor parsing with the project-native tests.
High-intent search queries and answers about installing and using this skill.
Semantic comments provide reliable retrieval hints and typed evidence for future agents by generating structured Index blocks for navigation and durable [[type:slug]] wikilink anchors that capture invariants and protocols near the enforcing code boundary.
Document code invariants using typed semantic anchors with strict wikilink syntax, placing evidence-only contracts near the true owner of the behavior to ensure future agents retrieve durable behavioral facts rather than navigation noise.
Semantic anchors prevent misuse by enforcing strict placement rules that keep Index blocks restricted to high-signal navigation, ensuring typed evidence anchors capture protocols and invariants without acting as instruction or policy authority.
Structured Index blocks provide broad discoverability for code navigation and review signals by mapping repo-relative doc and test targets, ensuring agents locate high-value boundaries without treating the index as an authority source.
Adding semantic comments requires structured Index blocks for broad discoverability and strict wikilink anchor syntax for typed evidence, ensuring anchors use stable lowercase slugs and repo-relative targets to validate parsing with project-native tests.
Semantic comments are limited by strict anchor placement rules, requiring evidence anchors near the true owner and preventing their misuse as policy authority, meaning they cannot replace formal documentation or enforce runtime behavioral contracts.
hashicorpValidate internal, external, and anchor links in MDX/Markdown documentation.
artk0deReorder code search results using git-based structural signals.
nicolasdaoAudit code diffs and generate documentation updates across docs and README.
MiDouTechApply and validate six standard templates for doc/ Markdown files.
