diff --git a/plugins/kyberforge/docs/README.md b/plugins/kyberforge/docs/README.md index c2dc27a..1f646a4 100644 --- a/plugins/kyberforge/docs/README.md +++ b/plugins/kyberforge/docs/README.md @@ -1,7 +1,20 @@ # docs/ -Plugin documentation. Place usage guides, reference material, and examples here. +Plugin documentation. Not read automatically by Claude Code or GitHub Copilot CLI — reference specific files from skill bodies or agent prompts as needed. -This directory is not read automatically by either Claude Code or GitHub Copilot CLI. -Reference specific files from your skill bodies or agent prompts when needed -(e.g. `See references/usage.md for examples`). +## Files + +| Path | Purpose | +|------|---------| +| `plugin-marketplace-architecture.md` | Claude Code vs Copilot CLI divergence, two-manifest pattern, plugin constraints, cross-tool compatibility | +| `adding-agents.md` | How to add agent definitions to the kyberforge plugin | + +## research/ + +Upstream reference material gathered during skill authoring. Not shipped with the plugin — used at development time only. + +| Path | Purpose | +|------|---------| +| `research/docs/agentskillsio/` | agentskills.io spec, skill authoring, description optimization, eval design, scripts | +| `research/docs/agentsmd/` | agents.md format spec and cross-tool configuration reference | +| `research/examples/skill-write/` | Upstream skill examples reviewed when authoring skill-write and skill-audit | diff --git a/plugins/kyberforge/docs/agentskillsio/evaluating-skills.md b/plugins/kyberforge/docs/research/docs/agentskillsio/evaluating-skills.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/evaluating-skills.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/evaluating-skills.md diff --git a/plugins/kyberforge/docs/agentskillsio/examples.md b/plugins/kyberforge/docs/research/docs/agentskillsio/examples.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/examples.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/examples.md diff --git a/plugins/kyberforge/docs/agentskillsio/optimizing-descriptions.md b/plugins/kyberforge/docs/research/docs/agentskillsio/optimizing-descriptions.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/optimizing-descriptions.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/optimizing-descriptions.md diff --git a/plugins/kyberforge/docs/agentskillsio/overview.md b/plugins/kyberforge/docs/research/docs/agentskillsio/overview.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/overview.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/overview.md diff --git a/plugins/kyberforge/docs/agentskillsio/scripts.md b/plugins/kyberforge/docs/research/docs/agentskillsio/scripts.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/scripts.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/scripts.md diff --git a/plugins/kyberforge/docs/agentskillsio/skill-authoring.md b/plugins/kyberforge/docs/research/docs/agentskillsio/skill-authoring.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/skill-authoring.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/skill-authoring.md diff --git a/plugins/kyberforge/docs/agentskillsio/sources.md b/plugins/kyberforge/docs/research/docs/agentskillsio/sources.md similarity index 81% rename from plugins/kyberforge/docs/agentskillsio/sources.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/sources.md index 6fcc3c8..4a246a9 100644 --- a/plugins/kyberforge/docs/agentskillsio/sources.md +++ b/plugins/kyberforge/docs/research/docs/agentskillsio/sources.md @@ -4,49 +4,49 @@ - **URL:** https://agentskills.io/home.md - **Description:** Agent Skills overview — what it is, why it exists, progressive disclosure model, ecosystem of 35+ implementing tools -- **Contributing files:** agentskills-overview.md +- **Contributing files:** overview.md - **Status:** `extracted` ## agentskills-spec - **URL:** https://agentskills.io/specification.md - **Description:** Complete SKILL.md format specification — frontmatter fields, constraints, body content, optional directories, progressive disclosure levels, file references, validation -- **Contributing files:** agentskills-overview.md, agentskills-specification.md, agentskills-examples.md +- **Contributing files:** overview.md, specification.md, examples.md - **Status:** `extracted` ## agentskills-best-practices - **URL:** https://agentskills.io/skill-creation/best-practices.md - **Description:** Best practices for skill creators — starting from real expertise, spending context wisely, calibrating control, instruction patterns (gotchas, templates, checklists, validation loops) -- **Contributing files:** agentskills-skill-authoring.md, agentskills-examples.md +- **Contributing files:** skill-authoring.md, examples.md - **Status:** `extracted` ## agentskills-optimizing-descriptions - **URL:** https://agentskills.io/skill-creation/optimizing-descriptions.md - **Description:** How to systematically test and improve skill descriptions for triggering accuracy — eval queries, trigger rate testing, train/validation splits, optimization loop -- **Contributing files:** agentskills-optimizing-descriptions.md, agentskills-examples.md +- **Contributing files:** optimizing-descriptions.md, examples.md - **Status:** `extracted` ## agentskills-evaluating-skills - **URL:** https://agentskills.io/skill-creation/evaluating-skills.md - **Description:** Eval-driven skill quality improvement — test case design, workspace structure, assertion writing, grading, benchmarking, human review, iteration loop -- **Contributing files:** agentskills-evaluating-skills.md, agentskills-examples.md +- **Contributing files:** evaluating-skills.md, examples.md - **Status:** `extracted` ## agentskills-using-scripts - **URL:** https://agentskills.io/skill-creation/using-scripts.md - **Description:** Using scripts in skills — one-off commands, self-contained scripts with inline dependencies, designing scripts for agentic use (no interactive prompts, --help, structured output, idempotency) -- **Contributing files:** agentskills-scripts.md +- **Contributing files:** scripts.md - **Status:** `extracted` ## agentskills-quickstart - **URL:** https://agentskills.io/skill-creation/quickstart.md - **Description:** Step-by-step guide to creating a first skill (roll-dice example), how discovery/activation/execution work in practice -- **Contributing files:** agentskills-overview.md, agentskills-examples.md +- **Contributing files:** overview.md, examples.md - **Status:** `extracted` ## agentskills-llms-txt diff --git a/plugins/kyberforge/docs/agentskillsio/specification.md b/plugins/kyberforge/docs/research/docs/agentskillsio/specification.md similarity index 100% rename from plugins/kyberforge/docs/agentskillsio/specification.md rename to plugins/kyberforge/docs/research/docs/agentskillsio/specification.md diff --git a/plugins/kyberforge/docs/agentsmd/configuration.md b/plugins/kyberforge/docs/research/docs/agentsmd/configuration.md similarity index 100% rename from plugins/kyberforge/docs/agentsmd/configuration.md rename to plugins/kyberforge/docs/research/docs/agentsmd/configuration.md diff --git a/plugins/kyberforge/docs/agentsmd/examples.md b/plugins/kyberforge/docs/research/docs/agentsmd/examples.md similarity index 100% rename from plugins/kyberforge/docs/agentsmd/examples.md rename to plugins/kyberforge/docs/research/docs/agentsmd/examples.md diff --git a/plugins/kyberforge/docs/agentsmd/overview.md b/plugins/kyberforge/docs/research/docs/agentsmd/overview.md similarity index 100% rename from plugins/kyberforge/docs/agentsmd/overview.md rename to plugins/kyberforge/docs/research/docs/agentsmd/overview.md diff --git a/plugins/kyberforge/docs/agentsmd/sources.md b/plugins/kyberforge/docs/research/docs/agentsmd/sources.md similarity index 100% rename from plugins/kyberforge/docs/agentsmd/sources.md rename to plugins/kyberforge/docs/research/docs/agentsmd/sources.md diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/LICENSE.txt b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/LICENSE.txt similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/LICENSE.txt rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/LICENSE.txt diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/SKILL.md b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/SKILL.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/SKILL.md rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/SKILL.md diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/agents/analyzer.md b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/agents/analyzer.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/agents/analyzer.md rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/agents/analyzer.md diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/agents/comparator.md b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/agents/comparator.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/agents/comparator.md rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/agents/comparator.md diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/agents/grader.md b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/agents/grader.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/agents/grader.md rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/agents/grader.md diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/assets/eval_review.html b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/assets/eval_review.html similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/assets/eval_review.html rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/assets/eval_review.html diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/eval-viewer/generate_review.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/eval-viewer/generate_review.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/eval-viewer/generate_review.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/eval-viewer/generate_review.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/eval-viewer/viewer.html b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/eval-viewer/viewer.html similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/eval-viewer/viewer.html rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/eval-viewer/viewer.html diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/references/schemas.md b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/references/schemas.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/references/schemas.md rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/references/schemas.md diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/__init__.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/__init__.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/__init__.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/__init__.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/aggregate_benchmark.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/aggregate_benchmark.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/aggregate_benchmark.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/aggregate_benchmark.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/generate_report.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/generate_report.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/generate_report.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/generate_report.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/improve_description.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/improve_description.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/improve_description.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/improve_description.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/package_skill.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/package_skill.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/package_skill.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/package_skill.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/quick_validate.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/quick_validate.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/quick_validate.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/quick_validate.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/run_eval.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/run_eval.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/run_eval.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/run_eval.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/run_loop.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/run_loop.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/run_loop.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/run_loop.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/utils.py b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/utils.py similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/scripts/utils.py rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/scripts/utils.py diff --git a/plugins/kyberforge/docs/examples/skill-write/skill-creator/sources.md b/plugins/kyberforge/docs/research/examples/skill-write/skill-creator/sources.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/skill-creator/sources.md rename to plugins/kyberforge/docs/research/examples/skill-write/skill-creator/sources.md diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/CATEGORIES.md b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/CATEGORIES.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/CATEGORIES.md rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/CATEGORIES.md diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/META-TEMPLATE.md b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/META-TEMPLATE.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/META-TEMPLATE.md rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/META-TEMPLATE.md diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/META.md b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/META.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/META.md rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/META.md diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/SKILL-TEMPLATE.md b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/SKILL-TEMPLATE.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/SKILL-TEMPLATE.md rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/SKILL-TEMPLATE.md diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/SKILL.md b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/SKILL.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/SKILL.md rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/SKILL.md diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/evals/eval.yaml b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/evals/eval.yaml similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/evals/eval.yaml rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/evals/eval.yaml diff --git a/plugins/kyberforge/docs/examples/skill-write/write-skill/sources.md b/plugins/kyberforge/docs/research/examples/skill-write/write-skill/sources.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/write-skill/sources.md rename to plugins/kyberforge/docs/research/examples/skill-write/write-skill/sources.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-great-skills/GLOSSARY.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-great-skills/GLOSSARY.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-great-skills/GLOSSARY.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-great-skills/GLOSSARY.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-great-skills/SKILL.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-great-skills/SKILL.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-great-skills/SKILL.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-great-skills/SKILL.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-great-skills/sources.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-great-skills/sources.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-great-skills/sources.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-great-skills/sources.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/SKILL.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/SKILL.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/SKILL.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/SKILL.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/anthropic-best-practices.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/anthropic-best-practices.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/anthropic-best-practices.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/anthropic-best-practices.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/examples/CLAUDE_MD_TESTING.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/examples/CLAUDE_MD_TESTING.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/examples/CLAUDE_MD_TESTING.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/examples/CLAUDE_MD_TESTING.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/graphviz-conventions.dot b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/graphviz-conventions.dot similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/graphviz-conventions.dot rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/graphviz-conventions.dot diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/persuasion-principles.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/persuasion-principles.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/persuasion-principles.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/persuasion-principles.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/render-graphs.js b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/render-graphs.js similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/render-graphs.js rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/render-graphs.js diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/sources.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/sources.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/sources.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/sources.md diff --git a/plugins/kyberforge/docs/examples/skill-write/writing-skills/testing-skills-with-subagents.md b/plugins/kyberforge/docs/research/examples/skill-write/writing-skills/testing-skills-with-subagents.md similarity index 100% rename from plugins/kyberforge/docs/examples/skill-write/writing-skills/testing-skills-with-subagents.md rename to plugins/kyberforge/docs/research/examples/skill-write/writing-skills/testing-skills-with-subagents.md