Astea AI Toolkit

A starter kit for teams using AI to understand a codebase, plan changes, implement them, and review the result. It brings together reusable skills, research agents, and a release-branch automation tool.

What's in the repository

Path	Contents
.claude/skills/	Skills with instructions, supporting scripts, references, and templates.
.claude/agents/	Claude Code research agent definitions.
.github/agents/	Copilot forms of those research agents.
branch-merger/	Portable merge-cascade script, GitHub Actions workflow, and setup guide.

Skills

See the skill catalog for purposes, use cases, origins, and licensing information.

Install skills with the skills CLI:

# List available skills without installing
npx skills add asteasolutions/ai-toolkit --list

# Install skills for Claude Code
npx skills add asteasolutions/ai-toolkit -a claude-code --copy

# Install one skill
npx skills add asteasolutions/ai-toolkit --skill tdd -a claude-code --copy

--copy writes real files into .claude/skills/. Read each selected skill's SKILL.md for prerequisites and invocation details.

For GitHub Copilot in VS Code, point skill discovery at the same directory in your repository's .vscode/settings.json:

{
  "chat.agentSkillsLocations": {
    ".claude/skills": true
  }
}

Agents

See the agent catalog for purposes, use cases, origins, and licensing information.

The skills CLI does not install standalone agents. Clone this repository, then copy the desired definition and its license into your project's agent directory. For example, in order to install grounded-explorer from the ai-toolkit local folder:

# Claude Code
mkdir -p <your-repo>/.claude/agents
cp -R .claude/agents/grounded-explorer <your-repo>/.claude/agents/

# GitHub Copilot
mkdir -p <your-repo>/.github/agents
cp -R .github/agents/grounded-explorer <your-repo>/.github/agents/

Choose the correct format for your harness.

Tooling

branch-merger keeps release branches and develop merged along a version-ordered chain. Use it for recurring release-branch maintenance: clean merges are pushed, AI resolutions pass configured checks, and uncertain conflicts become review PRs. Copy the script and workflow using its setup guide, configure credentials and build/test gates, and start with a dry run.

Licensing

Keep each resource's LICENSE or LICENSE.txt when copying it. The toolkit includes original and adapted material with per-resource licenses, including MIT and Apache-2.0; consult the root LICENSE and NOTICE in this distribution and the license inside each selected resource.

Contributing

The contents of this repository are overwritten on each release, so pull requests here will not be merged — a merged change would be erased by the next publish.

Bug reports and suggestions are welcome as issues.