git:20260921.a2e8de7 to git:20260921.1b04d43

4 added, 0 removed. Audit A to A.

# legends-github agent entry point

Use this workflow with any agent that can read files and execute commands. No particular model, native skill loader, or subagent framework is required.

## Work on a target repository

1. Resolve the toolkit and target as separate absolute paths. Read the target's instructions and check its Git status. Preserve existing user work.

2. Establish the user's objective, audience, repository type, and authorized changes. Inspect the actual implementation before recommending templates.

3. Run `python <toolkit>/legends_github.py verify --mode portable --path <target>`. All readiness modes check the portable runtime without requiring a host installation. Use `--offline --artifacts-dir <outside-target>` for an isolated local review. Optional provider failures do not block unrelated local work.

4. Run `python <toolkit>/legends_github.py audit --path <target>`, then inspect the evidence and proposed actions. These commands write local caches and reports. An audit score is a checklist, not proof of quality or ranking potential.

5. Choose the smallest relevant workflow using its `--help`. Distinguish observed facts, unavailable evidence, and hypotheses. Do not promote checklist points directly into business priorities.

6. Make authorized changes, inspect the diff, and run relevant checks. External mutations, paid services, and publishing must follow the user's actual authorization. Do not repeat approval requests for already authorized work.

7. Report concrete changes, verification, and remaining limitations. Do not promise higher rankings, stars, revenue, or universal host compatibility.

## Optional instructions and tools

Read specialized `skills/github-*/SKILL.md` instructions when useful. Legacy host-specific paths, mandatory multi-agent language, and optional-provider setup prompts are not requirements of this portable entry point. Translate supported operations into the current host's tools; run sequentially when delegation is unavailable or unnecessary.

Use configured providers only for requested capabilities. Never print credentials or load arbitrary dotenv contents into a shell command. Keep artwork optional and follow the repository owner's design direction.

## Contributing to this toolkit

Keep executable behavior in `github/scripts/`, with `legends_github.py` as the public launcher. Add regression tests for behavior changes. Keep host adapters thin and document their tested status. Do not remove legacy installers or change cache formats without a migration plan. Follow `docs/MODERNIZATION.md` for reconciliation scope.

+ ## DataForSEO research dependency

+ For measured demand and SERP research, install `requirements-dataforseo.txt` and use `research` to estimate before explicit execution. This uses the public legends-dataforseo-kit; no MCP installation is required. Follow `docs/SEO-RESEARCH.md`, preserve locale and observation dates, and import collected exports through `seo`. Offline audits remain independent of provider credentials.