igorwarzocha/agent-navigation-sop
agents/repo-navigator/skill/agent-navigation-sop/SKILL.md
Generate AGENTS.md for AI agent navigation. Covers build/test commands, coding conventions, task routing, and codebase structure. Use proactively during /init workflow or when creating agent-readable repository documentation. Examples: - user: "/init" → full AI navigation AGENTS.md + skill recommendations - user: "/init basic" → minimal AGENTS.md structure only - user: "Create AGENTS.md for this repo" → assess complexity, generate navigation doc - user: "Document codebase for AI agents" → structured AGENTS.md with task routing
$ install --global
skillsauthnpx skillsauth add igorwarzocha/opencode-workflows agent-navigation-sopInstall 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 5, 2026, 8:06 PM4.9s1 file scanned
SKILL.md
- name:
- agent-navigation-sop
- description:
- |-
- - user:
- Document codebase for AI agents" → structured AGENTS.md with task routing
Agent Navigation SOP
This SOP COMPLEMENTS the /init command by providing deep-dive mapping for developer-facing AGENTS.md files.
- Tooling & Scripts: Identify one-shot commands for Build, Test, Lint, and Typecheck.
- Process Constraints: Identify dev servers and watch-modes to EXCLUDE.
- Conventions: Identify project-specific naming, architectural patterns, and unique error handling.
Phase 2: AGENTS.md Composition
Target a high-density output of ~50 lines.
1. Build & Test (Instructions)
- List copy-pasteable, one-shot commands.
- MUST NOT include
dev,watch, or interactive commands.
2. Constraints & Patterns (Rules)
- CRITICAL: The agent MUST explicitly forbid running blocking processes (dev servers, watch modes).
- Identify read-only or restricted paths that agents SHOULD NOT modify.
- Document repository-specific coding patterns (e.g., "Use Bun APIs", "Prefer functional over class").
3. Task Routing (Routing)
- Map common tasks (feature addition, bug fix) to specific directories and related tests.
- Reference nested
AGENTS.mdfiles for package-level details instead of duplicating them. - Identify repetitive tasks and SHOULD suggest creating new skills using
skill-creatorto extend agent capabilities. </workflow>
Related Skills
igorwarzocha/writing
development
VerifiedTrustedCommunity
Handle structured co-authoring of professional documentation. Use for proposals, technical specs, and RFCs. Use proactively when a collaborative drafting process (Gathering -> Refinement -> Testing) is needed. Examples: - user: "Draft a technical RFC for the new API" -> follow Stage 1 context gathering - user: "Refine the introduction of this proposal" -> use iterative surgical edits - user: "Test if this document is clear for readers" -> run reader testing workflow
100SKILL.mdUpdated Apr 5, 2026
igorwarzocha/word
development
VerifiedTrustedCommunity
Handle Word document (.docx) creation, editing, and analysis with high-fidelity visual review. Use for professional reports, legal documents, and tracked changes. Use proactively when quality and precise formatting are critical. Examples: - user: "Create a professional report in Word" -> use python-docx with render loops - user: "Draft a legal contract with redlines" -> use ooxml redlining workflow - user: "Extract text from this DOCX while preserving structure" -> use pandoc markdown conversion
100SKILL.mdUpdated Apr 5, 2026
igorwarzocha/themes
testing
VerifiedTrustedCommunity
Apply professional visual themes to documents and presentations. Use for styling artifacts with consistent color palettes and font pairings. Use proactively to quickly improve the aesthetic quality of deliverables. Examples: - user: "Apply a modern theme to this deck" -> use Modern Minimalist theme - user: "I want a tech aesthetic for this doc" -> apply Tech Innovation theme - user: "Create a custom theme for my project" -> generate new color/font specification
100SKILL.mdUpdated Apr 5, 2026
igorwarzocha/skill-creator
tools
VerifiedTrustedCommunity
Guide for creating effective opencode skills. Use for creating or updating skills that extend agent capabilities with specialized knowledge, workflows, or tool integrations. Examples: - user: "Create a skill for git workflows" → define SKILL.md with instructions and examples - user: "Add examples to my skill" → follow the user: "query" → action pattern - user: "Update skill description" → use literal block scalar and trigger contexts - user: "Structure a complex skill" → organize with scripts/ and references/ directories - user: "Validate my skill" → check structure, frontmatter, and discovery triggers
100SKILL.mdUpdated Apr 5, 2026