github-copilot/.github/agents

Agents Index

This file is the top-level index for the custom agents in this repository.

Layout Convention

• Canonical agent file: .github/agents/<agent-name>.agent.md
• Canonical skills: .github/skills/<skill-name>/SKILL.md

The agents directory contains only agent definitions. All skills are centralized under .github/skills/.

Agent Overview

Agent	Purpose	Canonical Agent File	Canonical Skills Dir	Tools
Branch Review Engineer	Reviews branch diffs, proposes improvements, checks TestLink coverage for changed autotests, and applies approved fixes	branch-review.agent.md	.github/skills/	execute, read, edit, search, io.github.upstash/context7/*, testlink/*, todo
Docker Build & Test Engineer	Builds, validates, and repairs Docker images and container startup flows	docker-build-test.agent.md	.github/skills/	execute, read, edit, search, io.github.upstash/context7/*, ms-azuretools.vscode-containers/containerToolsConfig, todo
OpenWrt VPN & Network Engineer	Designs and validates OpenWrt VPN routing with DNS policy, split tunneling, GeoIP/ASN selectors, and selective tunnel rules by destination IP/domain	openwrt-network.agent.md	.github/skills/	execute, read, edit, search, web, io.github.upstash/context7/*, todo
TestLink Autotest Engineer	Generates autotests from TestLink cases, reviews them, and stabilizes the resulting test runs	testlink-autotest.agent.md	.github/skills/	execute, read, edit, search, io.github.upstash/context7/*, testlink/*, todo

Skills by Agent

Branch Review Engineer

• Agent: branch-review.agent.md
• Tools: execute, read, edit, search, io.github.upstash/context7/*, testlink/*, todo
• Skills:
  • branch-review-read-code
  • branch-review-analyze
  • branch-review-check-testlink
  • branch-review-propose
  • branch-review-apply
• Workflow shape:
  • read branch context and pyproject.toml
  • analyze improvements
  • optionally verify changed autotests against TestLink
  • propose improvements
  • apply only approved items
• Confirmation points:
  • before applying proposed fixes
  • when risky refactoring would exceed the changed scope

Docker Build & Test Engineer

• Agent: docker-build-test.agent.md
• Tools: execute, read, edit, search, io.github.upstash/context7/*, ms-azuretools.vscode-containers/containerToolsConfig, todo
• Skills:
  • dockerfile-builder
  • dockerfile-tester
• Workflow shape:
  • build draft container setup
  • validate build and runtime
  • loop on targeted repairs up to the retry limit
• Confirmation points:
  • after retry limit is hit
  • when required runtime inputs cannot be inferred

TestLink Autotest Engineer

• Agent: testlink-autotest.agent.md
• Tools: execute, read, edit, search, io.github.upstash/context7/*, testlink/*, todo
• Skills:
  • testlink-decompose
  • autotest-writer
  • python-review
  • test-runner
  • testlink-to-autotest
• Workflow shape:
  • fetch and decompose TestLink case
  • write autotests from mini-tests
  • review and improve test code
  • run and stabilize tests
• Confirmation points:
  • after mini-test decomposition
  • after optional green-tier suggestions from review

OpenWrt VPN & Network Engineer

• Agent: openwrt-network.agent.md
• Tools: execute, read, edit, search, web, io.github.upstash/context7/*, todo
• Skills:
  • openwrt-network-discovery
  • openwrt-vpn-routing
  • openwrt-network-hardening
• Workflow shape:
  • discover topology, policy constraints, and MCP/webhook requirements
  • design VPN and routing for xray/sing-box/WireGuard/OpenVPN
  • harden deployment and validate split tunnel/GeoIP/ASN behavior
• Confirmation points:
  • after discovery summary and before config planning
  • before execution of routing changes
  • when MCP/webhook integration data is incomplete

Canonical Paths

These are canonical and should remain stable:

• .github/agents/branch-review.agent.md
• .github/agents/docker-build-test.agent.md
• .github/agents/openwrt-network.agent.md
• .github/agents/testlink-autotest.agent.md
• .github/skills/*

When to Update This File

Update this index when:

• a new agent is added
• an agent gains or loses skills
• confirmation points or workflow stages change materially
• compatibility exports are renamed or removed