From 250c486ce17dcf87d8f45c38ea1ae537e3b0e8b2 Mon Sep 17 00:00:00 2001
From: Defame1297 <gitea@rkdr.net>
Date: Thu, 23 Jul 2026 17:31:14 +0000
Subject: [PATCH] docs(core): add plugin README

---
 plugins/core/README.md | 47 ++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)
 create mode 100644 plugins/core/README.md

diff --git a/plugins/core/README.md b/plugins/core/README.md
new file mode 100644
index 0000000..ec8bc67
--- /dev/null
+++ b/plugins/core/README.md
@@ -0,0 +1,47 @@
+# core
+
+Cross-cutting utility skills for everyday AI-assisted coding — triage, diagnosis, architecture review, and session navigation.
+
+## Install
+
+**Claude Code:**
+
+```bash
+claude plugin marketplace add <owner>/<repo>
+claude plugin install core@<marketplace-name>
+```
+
+**GitHub Copilot CLI:**
+
+```bash
+copilot plugin marketplace add <owner>/<repo>
+copilot plugin install core
+```
+
+**Local (development):**
+
+```bash
+# Claude Code
+claude --plugin-dir ./plugins/core
+
+# GitHub Copilot CLI
+copilot plugin install ./plugins/core
+```
+
+## Contents
+
+| Component | Path | Description |
+|---|---|---|
+| Skills | `skills/` | Slash commands available after install |
+
+## Skills
+
+| Skill | Description |
+|---|---|
+| `agentsmd-author` | Create or update a repo's AGENTS.md by exploring real build/test/lint conventions; supports nested monorepo placement and hands off to agentsmd-audit and provider-adapter-author |
+| `agentsmd-audit` | Audit a repo's AGENTS.md for embedded secrets, structural completeness, and drift; produces a findings report |
+| `provider-adapter-author` | Convert a provider-specific instruction file (CLAUDE.md, `.cursor/rules/*.mdc`, copilot-instructions.md, etc.) into a thin adapter that defers to AGENTS.md |
+
+## Author
+
+Defame1297