tqn-agent-forge 1.0.1__tar.gz

tqn_agent_forge-1.0.1/.gitignore

@@ -0,0 +1,143 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env
+.env.*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+.output
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp directory
+.temp
+
+# Sveltekit cache directory
+.svelte-kit/
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# Firebase cache directory
+.firebase/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# pnpm
+.pnpm-store
+
+# yarn v3
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/sdks
+!.yarn/versions
+
+# Vite files
+vite.config.js.timestamp-*
+vite.config.ts.timestamp-*
+.vite/

tqn_agent_forge-1.0.1/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: tqn-agent-forge
+Version: 1.0.1
+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, and Cursor.
+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.
+
+**12 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.
+
+**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
+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`.

tqn_agent_forge-1.0.1/README.md

@@ -0,0 +1,87 @@
+# 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, and Cursor.
+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.
+
+**12 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.
+
+**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
+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`.

tqn_agent_forge-1.0.1/agent_forge/__init__.py

@@ -0,0 +1,3 @@
+"""agent-forge — cross-CLI plugin marketplace installer."""
+
+__version__ = "1.0.1"

tqn_agent_forge-1.0.1/agent_forge/canonical.py

@@ -0,0 +1,116 @@
+"""Read the canonical plugin tree under plugins/<name>/."""
+
+import json
+from dataclasses import dataclass
+from functools import cached_property
+from pathlib import Path
+
+from agent_forge.frontmatter import parse_frontmatter
+
+
+@dataclass(frozen=True)
+class CanonicalSkill:
+    plugin_name: str
+    name: str
+    skill_dir: Path
+
+    @cached_property
+    def skill_md(self) -> Path:
+        return self.skill_dir / "SKILL.md"
+
+    @cached_property
+    def frontmatter(self) -> dict:
+        fm, _ = parse_frontmatter(self.skill_md.read_text())
+        return fm
+
+    @cached_property
+    def body(self) -> str:
+        _, body = parse_frontmatter(self.skill_md.read_text())
+        return body
+
+    def references(self) -> list[Path]:
+        ref_dir = self.skill_dir / "references"
+        return sorted(ref_dir.rglob("*.md")) if ref_dir.exists() else []
+
+    def scripts(self) -> list[Path]:
+        sd = self.skill_dir / "scripts"
+        return sorted(sd.rglob("*")) if sd.exists() else []
+
+    def assets(self) -> list[Path]:
+        ad = self.skill_dir / "assets"
+        return sorted(ad.rglob("*")) if ad.exists() else []
+
+
+@dataclass(frozen=True)
+class CanonicalAgent:
+    plugin_name: str
+    name: str
+    md_path: Path
+
+    @cached_property
+    def frontmatter(self) -> dict:
+        fm, _ = parse_frontmatter(self.md_path.read_text())
+        return fm
+
+    @cached_property
+    def body(self) -> str:
+        _, body = parse_frontmatter(self.md_path.read_text())
+        return body
+
+
+@dataclass(frozen=True)
+class CanonicalCommand:
+    plugin_name: str
+    name: str
+    md_path: Path
+
+
+@dataclass(frozen=True)
+class CanonicalPlugin:
+    plugin_dir: Path
+
+    @property
+    def name(self) -> str:
+        return self.plugin_dir.name
+
+    @cached_property
+    def manifest(self) -> dict:
+        return json.loads((self.plugin_dir / ".claude-plugin" / "plugin.json").read_text())
+
+    def skills(self) -> list[CanonicalSkill]:
+        skills_dir = self.plugin_dir / "skills"
+        if not skills_dir.exists():
+            return []
+        result = []
+        for sd in sorted(skills_dir.iterdir()):
+            if (sd / "SKILL.md").exists():
+                result.append(CanonicalSkill(self.name, sd.name, sd))
+        return result
+
+    def agents(self) -> list[CanonicalAgent]:
+        ad = self.plugin_dir / "agents"
+        if not ad.exists():
+            return []
+        return [
+            CanonicalAgent(self.name, p.stem, p)
+            for p in sorted(ad.glob("*.md"))
+        ]
+
+    def commands(self) -> list[CanonicalCommand]:
+        cd = self.plugin_dir / "commands"
+        if not cd.exists():
+            return []
+        return [
+            CanonicalCommand(self.name, p.stem, p)
+            for p in sorted(cd.glob("*.md"))
+        ]
+
+
+def discover_plugins(plugins_dir: Path) -> list[CanonicalPlugin]:
+    """All plugins discovered under plugins/<name>/.claude-plugin/plugin.json."""
+    if not plugins_dir.exists():
+        return []
+    return [
+        CanonicalPlugin(p.parent.parent)
+        for p in sorted(plugins_dir.glob("*/.claude-plugin/plugin.json"))
+    ]