Login
netresearch/agent-rules-skillSee repository165 files

Agent Rules

Use when creating or updating AGENTS.md files, .github/copilot-instructions.md, or other AI agent rule files, onboarding AI agents to a project, standardizing agent documentation, or when anyone mentions AGENTS.md, agent rules, project onboarding, or codebase documentation for AI agents.

Use this skillView repositoryView on skills.sh
Specification
Skill ID
netresearch/agent-rules-skill/agent-rules
Publisher
netresearch
Repository
agent-rules-skill
Installs
0
Files
165
License
See repository
Requires
Requires bash 4.3+, jq 1.7+, git 2.0+.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

netresearch/agent-rules-skill/agent-rulesInstalls these files
  • AGENTS.md
  • CLAUDE.md
  • SKILL.md
  • assets/example-workflows/validate-agents.yml
  • assets/root-thin.md
  • assets/root-verbose.md
  • assets/scoped/backend-go.md
  • assets/scoped/backend-php.md
  • assets/scoped/backend-python.md
  • assets/scoped/backend-typescript.md
  • assets/scoped/claude-code-skill.md
  • assets/scoped/cli.md
  • assets/scoped/concourse.md
  • assets/scoped/ddev.md
  • assets/scoped/docker.md
  • assets/scoped/documentation.md
  • assets/scoped/examples.md
  • assets/scoped/frontend-typescript.md
  • assets/scoped/github-actions.md
  • assets/scoped/gitlab-ci.md
  • assets/scoped/oro-bundle.md
  • assets/scoped/oro-project.md
  • assets/scoped/python-modern.md
  • assets/scoped/resources.md
  • assets/scoped/skill-repo.md
  • assets/scoped/symfony.md
  • assets/scoped/testing.md
  • assets/scoped/typo3-docs.md
  • assets/scoped/typo3-extension.md
  • assets/scoped/typo3-project.md
  • assets/scoped/typo3-testing.md
  • checkpoints.yaml
  • evals/evals.json
  • references/ai-contribution-guidelines.md
  • references/ai-tool-compatibility.md
  • references/directory-coverage.md
  • references/examples/coding-agent-cli/AGENTS.md
  • references/examples/coding-agent-cli/go.mod
  • references/examples/coding-agent-cli/scripts-AGENTS.md
  • references/examples/express-api-ts/.env.example
  • references/examples/express-api-ts/AGENTS.md
  • references/examples/express-api-ts/package.json
  • references/examples/express-api-ts/pnpm-lock.yaml
  • references/examples/express-api-ts/src/AGENTS.md
  • references/examples/express-api-ts/src/config.ts
  • references/examples/express-api-ts/src/controllers/userController.ts
  • references/examples/express-api-ts/src/index.ts
  • references/examples/express-api-ts/src/middleware/errorHandler.ts
  • references/examples/express-api-ts/src/middleware/requestLogger.ts
  • references/examples/express-api-ts/src/routes/health.ts
  • references/examples/express-api-ts/src/routes/users.ts
  • references/examples/express-api-ts/src/utils/errors.ts
  • references/examples/express-api-ts/src/utils/logger.ts
  • references/examples/express-api-ts/tsconfig.json
  • references/examples/fastapi-app/.env.example
  • references/examples/fastapi-app/AGENTS.md
  • references/examples/fastapi-app/pyproject.toml
  • references/examples/fastapi-app/src/AGENTS.md
  • references/examples/fastapi-app/src/__init__.py
  • references/examples/fastapi-app/src/config.py
  • references/examples/fastapi-app/src/main.py
  • references/examples/fastapi-app/src/models/__init__.py
  • references/examples/fastapi-app/src/models/item.py
  • references/examples/fastapi-app/src/models/user.py
  • references/examples/fastapi-app/src/routes/__init__.py
  • references/examples/fastapi-app/src/routes/health.py
  • references/examples/fastapi-app/src/routes/items.py
  • references/examples/fastapi-app/src/routes/users.py
  • references/examples/fastapi-app/src/services/__init__.py
  • references/examples/fastapi-app/src/services/item_service.py
  • references/examples/fastapi-app/src/services/user_service.py
  • references/examples/fastapi-app/uv.lock
  • references/examples/go-api-with-react-admin/.scopes
  • references/examples/go-api-with-react-admin/AGENTS.md
  • references/examples/go-api-with-react-admin/admin/package.json
  • references/examples/go-api-with-react-admin/admin/src/App.tsx
  • references/examples/go-api-with-react-admin/cmd/api/main.go
  • references/examples/go-api-with-react-admin/go.mod
  • references/examples/go-api-with-react-admin/main.go
  • references/examples/go-with-internal-web-tsx/.scopes
  • references/examples/go-with-internal-web-tsx/AGENTS.md
  • references/examples/go-with-internal-web-tsx/go.mod
  • references/examples/go-with-internal-web-tsx/internal/web/AGENTS.md
  • references/examples/go-with-internal-web-tsx/internal/web/package.json
  • references/examples/go-with-internal-web-tsx/internal/web/src/App.tsx
  • references/examples/go-with-internal-web-tsx/internal/web/src/Button.tsx
  • references/examples/go-with-internal-web-tsx/internal/web/src/Footer.tsx
  • references/examples/go-with-internal-web-tsx/internal/web/src/Header.tsx
  • references/examples/go-with-internal-web-tsx/internal/web/src/Sidebar.tsx
  • references/examples/go-with-internal-web-tsx/main.go
  • references/examples/go-with-internal-web-tsx/package-lock.json
  • references/examples/go-with-internal-web-tsx/package.json
  • references/examples/ldap-selfservice/AGENTS.md
  • references/examples/ldap-selfservice/go.mod
  • references/examples/ldap-selfservice/internal-AGENTS.md
  • references/examples/ldap-selfservice/internal-web-AGENTS.md
  • references/examples/php-with-frontend/.scopes
  • references/examples/php-with-frontend/AGENTS.md
  • references/examples/php-with-frontend/composer.json
  • references/examples/php-with-frontend/package.json
  • references/examples/php-with-frontend/pnpm-lock.yaml
  • references/examples/php-with-frontend/src/Controller.php
  • references/examples/php-with-frontend/web/AGENTS.md
  • references/examples/php-with-frontend/web/package.json
  • references/examples/php-with-frontend/web/src/App.tsx
  • references/examples/php-with-frontend/web/src/Button.tsx
  • references/examples/php-with-frontend/web/src/Footer.tsx
  • references/examples/php-with-frontend/web/src/Header.tsx
  • references/examples/php-with-frontend/web/src/main.tsx
  • references/examples/php-with-frontend/web/tsconfig.json
  • references/examples/pnpm-workspace/AGENTS.md
  • references/examples/pnpm-workspace/package.json
  • references/examples/pnpm-workspace/packages/web/package.json
  • references/examples/pnpm-workspace/packages/web/src/index.ts
  • references/examples/pnpm-workspace/pnpm-lock.yaml
  • references/examples/pnpm-workspace/pnpm-workspace.yaml
  • references/examples/simple-ldap-go/AGENTS.md
  • references/examples/simple-ldap-go/examples-AGENTS.md
  • references/examples/simple-ldap-go/go.mod
  • references/examples/t3x-rte-ckeditor-image/AGENTS.md
  • references/examples/t3x-rte-ckeditor-image/Classes-AGENTS.md
  • references/examples/t3x-rte-ckeditor-image/composer.json
  • references/feedback-memory-schema.md
  • references/fleet-sync-sweep.md
  • references/git-hooks-setup.md
  • references/output-structure.md
  • references/quality-rubric.md
  • references/scripts-guide.md
  • references/verification-guide.md
  • scripts/analyze-git-history.sh
  • scripts/check-freshness.sh
  • scripts/detect-golden-samples.sh
  • scripts/detect-heuristics.sh
  • scripts/detect-project.sh
  • scripts/detect-scopes.sh
  • scripts/detect-utilities.sh
  • scripts/extract-adrs.sh
  • scripts/extract-agent-configs.sh
  • scripts/extract-architecture-rules.sh
  • scripts/extract-ci-commands.sh
  • scripts/extract-ci-rules.sh
  • scripts/extract-commands.sh
  • scripts/extract-documentation.sh
  • scripts/extract-github-rulesets.sh
  • scripts/extract-github-settings.sh
  • scripts/extract-ide-settings.sh
  • scripts/extract-platform-files.sh
  • scripts/extract-quality-configs.sh
  • scripts/generate-agents.sh
  • scripts/generate-file-map.sh
  • scripts/lib/config-root.sh
  • scripts/lib/summary.sh
  • scripts/lib/template.sh
  • scripts/score-agents.sh
  • scripts/tests/test-claude-import-file.sh
  • scripts/tests/test-command-allowlist.sh
  • scripts/tests/test-dependency-tree-exclusion.sh
  • scripts/tests/test-extract-commands-real-scripts.sh
  • scripts/tests/test-json-manifest.sh
  • scripts/tests/test-scope-index-heading.sh
  • scripts/tests/test-scope-index-keeps-existing.sh
  • scripts/tests/test-symlink-write-boundary.sh
  • scripts/validate-structure.sh
  • scripts/verify-commands.sh
  • scripts/verify-content.sh

What this skill tells the agent

AGENTS.md Generator Skill

Generate and maintain AGENTS.md files following the agents.md convention. AGENTS.md is FOR AGENTS, not humans.

When to Use

  • Creating or updating AGENTS.md for new/existing projects
  • Scaffolding a new repository — ship AGENTS.md with the initial commits; retrofitting later needs full re-verification
  • Standardizing agent documentation across repositories
  • Checking AGENTS.md freshness after code changes
  • Onboarding AI agents to an unfamiliar codebase

Scripts

Call every script by its full path: bash ${CLAUDE_SKILL_DIR}/scripts/<name> PATH. Calling one relative to the working directory is not covered by the frontmatter rule and raises a permission prompt per call.

ScriptPurpose
generate-agents.sh PATHGenerate AGENTS.md files
validate-structure.sh PATHValidate structure compliance
check-freshness.sh PATHCheck if files are outdated
verify-content.sh PATHVerify documented files/commands match codebase
verify-commands.sh PATHVerify documented commands execute
score-agents.sh PATHGrade AGENTS.md quality, worst-first
detect-project.sh PATHDetect language, version, build tools
detect-scopes.sh PATHIdentify directories needing scoped files
extract-commands.sh PATHExtract commands from build configs
extract-ci-rules.sh PATHExtract CI quality gates and version matrix
extract-architecture-rules.sh PATHExtract module boundaries
extract-adrs.sh PATHExtract architectural decision records
extract-github-rulesets.sh PATHExtract GitHub rulesets and merge rules

See references/scripts-guide.md for full options.

Workflow

  1. Detect: detect-project.sh + detect-scopes.sh — stacks and subsystems
  2. Extract: extract-commands.sh, extract-ci-rules.sh — gather facts
  3. Generate: generate-agents.sh --style=thin (default) or --verbose
  4. Verify: verify-content.sh + verify-commands.sh -- MANDATORY before done

--update preserves curated content outside <!-- GENERATED --> markers.

Core Principles

  • Structured over Prose -- tables parse faster than paragraphs
  • Never Fabricate -- only document what exists; verify every command and path
  • Pointer Principle -- point to files, don't duplicate content
  • Auto Symlinks -- CLAUDE.md/GEMINI.md by default (`ai-tool-compatibility.md`)

References

FileContents
`verification-guide.md`Verification steps, anti-bloat, preservation check
`fleet-sync-sweep.md`Fleet-wide AGENTS.md sweeps
`scripts-guide.md`Script options, validation checklist
`quality-rubric.md`Grading rubric
`ai-tool-compatibility.md`16-agent compatibility matrix
`output-structure.md`Root/scoped sections
`git-hooks-setup.md`Hook framework setup
`examples/`Complete examples
`ai-contribution-guidelines.md`"3 Cs" AI-contribution framework
`directory-coverage.md`Scoped-file coverage rationale
`feedback-memory-schema.md`Approved-learning file format

Templates

Root: assets/root-thin.md (default) or root-verbose.md. Scoped: assets/scoped/, one per stack (Go/PHP/Python/TYPO3/Symfony/Oro/CLI/TS/skill-repo).

Supported Projects

Go, PHP (Composer/Laravel/Symfony/TYPO3/Oro), TypeScript (React/Next/Vue/Node), Python (pip/poetry/ruff/mypy), skill repos, hybrid.

See Also

More from netresearch

netresearch/context7-skill

Context7

Use when looking up library documentation, API references, framework patterns, or code examples for ANY library (React, Next.js, Vue, Django, Laravel, etc.) and the Context7 MCP server is unavailable or not configured. Fetches the same current docs directly via the Context7 REST API as a fallback. Triggers on: how to use library, API docs, framework pattern, import usage, library example.

netresearch/file-search-skill

File Search

Use when searching codebases (text, structural/AST, files by name, PDFs/archives, code stats) or building context before a task.

netresearch/git-workflow-skill

Git Workflow

Use when establishing branching strategies, implementing Conventional Commits, creating or reviewing PRs, resolving PR review comments, merging PRs (including CI verification, auto-merge queues, and post-merge cleanup), managing PR review threads, merging PRs with signed commits, handling merge conflicts, verifying a merge didn't silently drop changes, syncing a long-diverged branch (e.g. master into integration), rebasing a long-lived branch onto a moved base or splitting one into several PRs, integrating Git with CI/CD, setting up git hooks (lefthook, captainhook, husky, pre-commit), debugging hook-install failures in git worktrees, or working in a bare-repo plus per-branch-worktree layout, including consolidating a directory that holds both a plain clone and a .bare. The pull-request tooling is GitHub-only; references/pull-request-workflow.md carries the GitLab equivalents. Not for creating releases (use github-release) or diagnosing BLOCKED/won't-merge PRs (use github-project).

Use this skill in a project

Open any RiverX project, search the Skills panel for netresearch/agent-rules-skill/agent-rules, and install it in one click.

Use this skill