Skip to content

add mini-context-graph skill - A persistent, compounding knowledge base#1495

Open
fizznix wants to merge 41 commits intogithub:stagedfrom
fizznix:mini-context-graph-skill
Open

add mini-context-graph skill - A persistent, compounding knowledge base#1495
fizznix wants to merge 41 commits intogithub:stagedfrom
fizznix:mini-context-graph-skill

Conversation

@fizznix
Copy link
Copy Markdown

@fizznix fizznix commented Apr 24, 2026

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • I have read and followed the Guidance for submissions involving paid services.
  • My contribution adds a new instruction, prompt, agent, skill, or workflow file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, agent, skill, or workflow with GitHub Copilot.
  • I have run npm start and verified that README.md is up to date.
  • I am targeting the staged branch for this pull request.

Description

Introduces mini-context-graph, a skill that builds persistent, compounding knowledge bases by combining wiki pages with a structured knowledge graph. Unlike standard RAG that re-discovers knowledge on every query, this skill ingests documents once and maintains evolving knowledge that accumulates and cross-references over time.

Architecture

Three-layer knowledge storage:

  1. Raw Sources — Original documents stored immutably with chunk metadata
  2. Wiki Layer — LLM-written markdown pages with cross-references that grow richer over time
  3. Graph Layer — Extracted entities and relations with provenance links back to supporting text

What's included

  • SKILL.md — Core concepts, quick start, operations, and constraints
  • ingestion.md — Entity/relation extraction rules and workflow
  • ontology.md — Type normalization and entity deduplication
  • retrieval.md — Query execution and BFS graph traversal
  • lint.md — Wiki health checks and maintenance procedures
  • scripts/ — Python implementation:
    • contextgraph.py — Main skill interface
    • tools/ — Graph store, wiki store, document store, retrieval engine, and index management

Key features

  • Knowledge accumulation — Learns once, answers faster on subsequent queries
  • Provenance tracking — Every entity and relation links back to original source text
  • Wiki-first retrieval — Fast path using markdown pages before expensive graph traversal
  • Evidence-based answers — Returns supporting documents and reasoning chains
  • Graph-aware queries — BFS traversal across entities and relations (max depth: 2)
  • Automated wiki maintenance — Lint checks for orphaned pages, broken links, and contradictions

Type of Contribution

  • New instruction file.
  • New prompt file.
  • New agent file.
  • New plugin.
  • New skill file.
  • New agentic workflow.
  • Update to existing instruction, prompt, agent, plugin, skill, or workflow.
  • Other (please specify):

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

@fizznix fizznix requested a review from aaronpowell as a code owner April 24, 2026 08:14
@github-actions
Copy link
Copy Markdown
Contributor

🔍 Skill Validator Results

✅ All checks passed

Scope Checked
Skills 1
Agents 1
Total 2
Severity Count
--- ---:
❌ Errors 0
⚠️ Warnings 0
ℹ️ Advisories 0

Summary

Level Finding
ℹ️ Found 1 skill(s)
ℹ️ [mini-context-graph] 📊 mini-context-graph: 1,945 BPE tokens [chars/4: 2,418] (detailed ✓), 25 sections, 2 code blocks
ℹ️ ✅ All checks passed (1 skill(s))
Full validator output ```text Found 1 skill(s) [mini-context-graph] 📊 mini-context-graph: 1,945 BPE tokens [chars/4: 2,418] (detailed ✓), 25 sections, 2 code blocks ✅ All checks passed (1 skill(s)) ```

Copy link
Copy Markdown
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Additional files for a skill should be in the assets or references folder per the Skills spec (and scripts but that's already used in this PR).

rbgmulmb and others added 26 commits April 29, 2026 20:58
* update eval-driven-dev skill

* fix: update skill update command to use correct repository path

* address comments.

* update eval driven dev
* new skill batch-files

* batch-files: codespell, re-run start, suggestions, txt assets

codespellrc: add FO for tasklist option

validate-readme: re-run npm start

apply suggestions from code review

batch-files: change asset templates to text files

* codespellrc: resolve spelling in comment
…elopment (github#1454)

* feat: add minecraft-plugin-development skill

* docs: expand minecraft plugin skill patterns

* docs: add minecraft skill examples

* docs: generalize minecraft skill patterns

* docs: expand minecraft progression guidance

* docs: add minecraft plugin validation workflow

---------

Co-authored-by: jiang <helloworld@jiang.cn>
…#1388)

* Add error recovery hooks and PyInstaller frozen build recipes

* fixed datas to data
* Add resemble-detect skill

Deepfake detection and media safety skill using Resemble AI — detects
AI-generated audio, images, video, and text with confidence scores,
traces audio source platforms, applies and reads watermarks, verifies
speaker identity, and extracts media intelligence (speaker, emotion,
misinformation signals).

Packaged as SKILL.md + LICENSE (Apache-2.0). Generated docs updated
via npm start per CONTRIBUTING.md.

* resemble-detect: trim body under 500 lines + add compatibility

Moves detailed request/response schemas from SKILL.md into
references/api-reference.md, bringing the SKILL body from 557 to
282 lines (validator hard cap is 500). Core decision-making content
— capability decision tree, score interpretation, workflows, red
flags — stays in the body where the agent needs it at query time.

Also adds a compatibility field to frontmatter per review feedback:
surfaces the RESEMBLE_API_KEY requirement and the public-HTTPS-URL
constraint upfront.

* Fix resemble-detect skill metadata
* new skill adobe-illustrator-scripting

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
* Add vardoger-analyze skill

Made-with: Cursor

* fix Copilot session-state path in vardoger-analyze SKILL.md

* add numbered workflow overview to satisfy skill-validator

The dotnet/skills validator's NumberedStepRegex (^\d+\.\s, multiline)
only matches ordered list items at line start, not ### numbered
headings, so the previous '### 1. …' layout triggered the
'No numbered workflow steps' warning on PR github#1461. Keep the existing
step headings for structure and add a short numbered Workflow
summary that the regex picks up.

* regenerate docs/README.skills.md for vardoger-analyze
* feat: add impediment prioritization skill and scoring rubric. This has been derived from Value Stream Mapping processing.

* chore: regenerate README for impediment-prioritization skill

* Update skills/impediment-prioritization/SKILL.md

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update skills/impediment-prioritization/SKILL.md

removed redundant code

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update skills/impediment-prioritization/SKILL.md

agreed for accuracy

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* refactor: update skill documentation for impediment prioritization and enhance downstream integration details

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
… in CONTRIBUTING.md (github#1468)

* fix: correct link for adding agents in CONTRIBUTING.md
removing outdated prompts-link

* feat: add Terminal Helper agent for PowerShell and Bash command assistance

* fix: rename task to validate-plugins and update command details
as collections are outdated
github#717

* update name format for terminal helper to lowercase

* update scope description for terminal context clarity
Co-authored-by: Antonio Villanueva <anvillan@microsoft.com>
…is (github#1487)

* feat: add data-breach-blast-radius skill for pre-breach impact analysis

* fix: resolve codespell false positives (ZAR currency code, SME abbreviation)

* fix: remove ZAR abbreviation to pass codespell check
* sync: java-upgrade plugin update from devdiv-azure-service-dmitryr/azure-java-migration-copilot-vscode-extension@187b2f8

Source commit: 187b2f85130550fbb5213b55347ab4afbb8c17e1

Source branch: xiading/sync-java-2

Triggered by: xiading_microsoft

Workflow: https://github.com/devdiv-azure-service-dmitryr/azure-java-migration-copilot-vscode-extension/actions/runs/24984055440

* Fix modernize-java plugin checklist issues

- Fix keyword casing: 'Java' → 'java' in plugin.json
- Add plugins/modernize-java/README.md based on upstream microsoft/modernize-java
- Remove hook declarations referencing missing scripts (recordToolUse.sh/.ps1)
- Run npm run build to update docs/README.plugins.md, docs/README.agents.md, and marketplace.json

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Fix README install command to use awesome-copilot marketplace

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: app_modernization <app_modernization@example.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ithub#1537)

* Add migration guide from javax to jakarta namespace

This document provides a comprehensive guide for migrating Java code from the javax namespace to the jakarta namespace, including steps for scanning, updating dependencies, and verifying the migration.

* Add javax to jakarta migration skill entry
* Fixing gh skill to be gh skills and adding to the README

* Adding skills install instruction to readme

* Fixing escapes
…mprovements (github#1525)

- Document new HTTP hook type (v1.0.35): hooks can now POST JSON to a URL
  instead of running a local command, enabling centralized audit/notification
  services without distributing scripts to every developer's machine
- Document preToolUse matcher field (v1.0.36): clarify that matcher is a regex
  filter on tool name; add important upgrade note about v1.0.36 behavioral fix
  (previously matcher was silently ignored)
- Update Security Gating example to show matcher field targeting the bash tool
- Add HTTP hook practical example for session-end audit webhook
- Note that plugins take effect immediately after install (v1.0.35, no restart needed)
- Update lastUpdated dates on both pages

Sources:
- https://github.com/github/copilot-cli/releases/tag/v1.0.35
- https://github.com/github/copilot-cli/releases/tag/v1.0.36

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
* removing old scripts

* consolidated folder

* Updating usage of scripts

* Adding script to generate an open PR report, rather than making AI gen it each time

* Adding step to close old quality report discussions
… Dev Team, QA agents (github#1504)

* Add ai-team-orchestration plugin: multi-agent dev team with Producer, Dev Team, QA agents

* fix: use kebab-case agent names to match filenames

* fix: regenerate README after agent name change

* fix: address Copilot review — add edit tools to Producer/QA, use GitHub closing keywords

* fix: update agent tools to official VS Code tool set names

Replace outdated/nonexistent tool names with current official tool sets:
- Producer: search, read, edit, web (removed nonexistent githubRepo)
- Dev Team: search, read, edit, execute, web (replaced runCommands, problems, usages, etc.)
- QA: search, read, edit, execute, web (removed nonexistent findTestFiles, runTests)

Ref: https://code.visualstudio.com/docs/copilot/reference/copilot-vscode-features#_chat-tools

* fix: remove frontmatter from plugin README per reviewer feedback

---------

Co-authored-by: Aaron Powell <me@aaron-powell.com>
aaronpowell and others added 14 commits April 29, 2026 21:15
…b#1428)

* Add brag-sheet skill — work impact writer for performance reviews

* polish: improve skill with frontmatter, fallbacks, cross-platform guidance

* improve skill with routing table, anti-patterns, evidence ladder, gotchas

* trim skill to reduce token count, run npm start to update docs
…ithub#1431)

* feat(skills): add IoT edge skills and align agent/instruction docs

* fix(ci): handle fork permission errors in plugin structure check

* fix(ci): allow intentional Spanish vocabulary in codespell

* docs(skills): translate IoT edge skill content to English

* fix(ci): pass codespell and README validation

* chore: regenerate skills index after merge
Co-authored-by: Your Name <your-email@example.com>
* feat: move to xml top tags for ebtter llm parsing and structure

- Orchestrator is now purely an orchestrator
- Added new calrify  phase for immediate user erequest understanding and task parsing before workflow
- Enforce review/ critic to plan instea dof 3x plan generation retries for better error handling and self-correction
- Add hins to all agents
- Optimize defitons for simplicity/ conciseness while maintaining clarity

* feat(critic): add holistic review and final review enhancements

* chore: bump marketplace version to 1.10.0

- Updated `.github/plugin/marketplace.json` to version 1.10.0.
- Revised `agents/gem-browser-tester.agent.md` to improve the BROWSER TESTER role documentation with a clearer structure, explicit role header, and organized knowledge sources section.

* refactor: streamline verification and self‑critique steps across browser‑tester, code‑simplifier, critic, and debugger agents

* feat(researcher): improve mode selection workflow and research implementation details

- Refine **Clarify** mode description to emphasize minimal research for detecting ambiguities.
- Reorder steps and clarify intent detection (`continue_plan`, `modify_plan`, `new_task`).
- Add explicit sub‑steps for presenting architectural and task‑specific clarifications.
- Update **Research** mode section with clearer initialization workflow.
- Simplify and reformat the confidence calculation comments for readability.
- Minor formatting tweaks and added blank lines for visual separation.

* Update gem-orchestrator.agent.md

* docs(gem-browser-tester): enhance BROWSER TESTER role description and clarify workflow steps- Expanded the BROWSER TESTER role with explicit responsibilities and constraints
- Reformatted the Knowledge Sources list using consistent numbered items for readability- Updated the Workflow section to detail initialization, execution, and teardown steps more clearly- Refined the Output Format and Research Format Guide structures to use proper markdown syntax
- Improved overall formatting and consistency of documentation for better maintainability

* docs: fix typo in delegation description
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…ithub#1543)

Three agent files had a trailing comma after the last element in their
YAML flow-sequence tools arrays. When parsed, this produces an empty
string as an extra tool entry, which the Copilot API rejects with:

  CAPIError: 400 Invalid 'tools[N].function.name': empty string

Affected files:
- agents/kusto-assistant.agent.md
- agents/mentoring-juniors.agent.md
- agents/address-comments.agent.md

Co-authored-by: ilderaj <>
)

- copilot-configuration-basics.md:
  - Add continueOnAutoMode config setting (v1.0.35)
  - Document --name/--resume=<name> for named sessions (v1.0.35)
  - Add /session delete, delete <id>, delete-all subcommands (v1.0.35)
  - Add session picker sort order (press 's', v1.0.37)
  - Update /ask to note markdown rendering including tables (v1.0.37)
  - Update /statusline to mention 'changes' line-count toggle (v1.0.36)
  - Add /keep-alive command (now available without experimental mode, v1.0.36)

- using-copilot-coding-agent.md:
  - Document /remote on and /remote off subcommands and status display (v1.0.36)

- automating-with-hooks.md:
  - Add note on location-based permission persistence enabled by default (v1.0.37)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Antonio Villanueva <anvillan@microsoft.com>
* feat: add AWS Cloud Expert agent 🤖🤖🤖

Adds a domain-specific AWS Cloud Expert agent covering the full AWS
ecosystem — serverless, containers, databases, networking, IaC
(CDK/SAM/CloudFormation), security, cost optimization, and observability.
Grounded in the AWS Well-Architected Framework with opinionated
production-ready defaults.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

* fix: use lowercase hyphenated name to pass agent validator

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

---------

Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
* Removing search from the home pageThis was a little confusing because there are two searches, but the overall site search is a lot more powerful

* Prefilter website search by resource page

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* small error handling and formatting

* Simplify website listing controls

Remove per-page text search, trim page-specific controls, and move remaining sort/filter controls into compact flyouts.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@fizznix fizznix requested a review from brunoborges as a code owner April 29, 2026 15:48
@aaronpowell
Copy link
Copy Markdown
Contributor

Looks like something is messed up on the branch for this PR - might be easier to discard it and start again

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.