Metadata-Version: 2.4
Name: tqn-agent-forge
Version: 1.1.0
Summary: Cross-CLI plugin marketplace installer for agent-forge
Project-URL: Homepage, https://github.com/tqnonline/agent-forge
Project-URL: Repository, https://github.com/tqnonline/agent-forge
Project-URL: Issues, https://github.com/tqnonline/agent-forge/issues
Author-email: Rahul N Akmol <rahulnakmol@gmail.com>
License: BSD-3-Clause
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: httpx>=0.27
Requires-Dist: platformdirs>=4.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: tomli-w>=1.0
Description-Content-Type: text/markdown

# agent-forge

[![GitHub Release](https://img.shields.io/github/v/release/tqnonline/agent-forge?style=flat-square)](https://github.com/tqnonline/agent-forge/releases/latest)
[![PyPI](https://img.shields.io/pypi/v/tqn-agent-forge?style=flat-square)](https://pypi.org/project/tqn-agent-forge/)
[![License](https://img.shields.io/github/license/tqnonline/agent-forge?style=flat-square)](LICENSE)
[![Tests](https://img.shields.io/github/actions/workflow/status/tqnonline/agent-forge/ci-structural.yml?label=tests&style=flat-square)](https://github.com/tqnonline/agent-forge/actions/workflows/ci-structural.yml)

A curated, BSD-3-Clause marketplace of agent skills, plugins, and slash commands.
Works natively with Claude Code, GitHub Copilot CLI, OpenAI Codex CLI, Cursor,
and Factory.ai Droid (CLI + desktop app). Git-URL install for Amp and Gemini
CLI. Copy-to-home adapters for Kilo Code, OpenCode, and Crush. Portable prompt
loaders for Perplexity, ChatGPT GPTs, and Claude.ai Projects.

**13 install targets. 4 plugins. 46 skills. One canonical source.**

## 30-second install

**Claude Code:**
```bash
claude plugin marketplace add github:tqnonline/agent-forge
claude plugin install writing
```

**GitHub Copilot CLI:**
```bash
copilot plugin marketplace add tqnonline/agent-forge
```

**Codex CLI:**
```bash
codex plugin marketplace add tqnonline/agent-forge
```

**Cursor:** Open `cursor.com/marketplace`, search "agent-forge", click Install.

**Factory.ai Droid (CLI + desktop):**
```bash
droid plugin marketplace add https://github.com/tqnonline/agent-forge
droid plugin install writing@agent-forge
```

**Amp:**
```bash
amp skill add github:tqnonline/agent-forge
```

**Gemini CLI:**
```bash
gemini skills install github:tqnonline/agent-forge
```

**Kilo Code, OpenCode, or Crush:**
```bash
pipx install tqn-agent-forge   # or: uv tool install tqn-agent-forge
agent-forge install writing --tier kilocode   # or opencode, or crush
```

**Perplexity, ChatGPT GPTs, Claude.ai Projects:** See [docs/install/_index.md](./docs/install/_index.md) — these use prompt loaders rather than native install.

## What's in the marketplace

| Plugin | Skills | Description |
|---|---|---|
| `writing` | humanize | Detect AI writing patterns and rewrite in natural human voice |
| `prompts` | prompt-forge | Interactive prompt engineering via structured dialogue |
| `msft-arch` | 32 skills | Microsoft enterprise architecture: Azure, M365, Power Platform, Dynamics 365 |
| `pm` | 12 skills | Product/Program Management: PRD generation, epic decomposition, 11-Star review |

## Telling an agent to install

Paste this into any LLM agent:

> Install agent-forge plugins from  
> https://raw.githubusercontent.com/tqnonline/agent-forge/main/docs/install/_index.md

The agent fetches the catalog, identifies your tool, and runs the correct install commands.

## Updating

```bash
agent-forge update --check    # see what's stale
agent-forge update            # apply
```

## Contributing

See [CONTRIBUTING.md](./CONTRIBUTING.md). Three paths: typo fix (no issue needed),
new skill (must include eval suite), new plugin (requires ADR discussion). DCO sign-off
required (`git commit -s`).

## License

BSD-3-Clause. Per-plugin assets may carry their own licenses; see `THIRD_PARTY_NOTICES.md`.
