igorwarzocha/opencode-workflows97 installs

agent-navigation-sop

Q: How do I install this agent skill?

Run npx skills add https://github.com/igorwarzocha/opencode-workflows --skill agent-navigation-sop.

Q: Is this agent skill safe to install?

Review the displayed partner audits, complete source, permissions, dependencies, and exact revision before installing.

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

How do I install this agent skill?

npx skills add https://github.com/igorwarzocha/opencode-workflows --skill agent-navigation-sop

view source ↗

Is this agent skill safe to install?

Gen Agent Trust Hubpass
The skill provides instructions for generating documentation to help AI agents navigate codebases. It includes safeguards such as explicitly forbidding blocking processes and identifying restricted file paths. No malicious patterns or security risks were identified.
Socketpass
No alerts
Snykpass
Risk: LOW · No issues
Runlayerpass
1/1 file flagged

What does this agent skill do?

Agent Navigation SOP

This SOP COMPLEMENTS the /init command by providing deep-dive mapping for developer-facing AGENTS.md files.

<workflow> ## Phase 1: Deep Analysis The agent SHOULD skip basic directory scans (opencode already sees the tree) and focus on:

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.md files for package-level details instead of duplicating them.
Identify repetitive tasks and SHOULD suggest creating new skills using skill-creator to extend agent capabilities. </workflow>

<instructions> - The agent MUST NOT repeat environment metadata (date, OS, absolute paths). - Output length of ~50 lines is STRONGLY RECOMMENDED. - The agent MUST use RFC 2119 keywords (MUST, MUST NOT, SHOULD, STRONGLY RECOMMENDED). - The agent MUST prioritize "Access Constraints" (read-only files/folders). - The agent MUST NOT document long-running/blocking processes. - The agent MUST document one-shot verification commands (build, lint, test, typecheck, codegen). - The agent MUST NOT include prose that does not change agent behavior. </instructions>

How can the creator link this skill?

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/igorwarzocha/opencode-workflows/agent-navigation-sop">View agent-navigation-sop on skillZs</a>