Skip to content

Add readme documentation reference to power-grid-model-ai skills#1449

Draft
Cing2 wants to merge 2 commits into
PowerGridModel:mainfrom
Cing2:feature/doc_ai_skill
Draft

Add readme documentation reference to power-grid-model-ai skills#1449
Cing2 wants to merge 2 commits into
PowerGridModel:mainfrom
Cing2:feature/doc_ai_skill

Conversation

@Cing2

@Cing2 Cing2 commented Jun 24, 2026

Copy link
Copy Markdown

@nitbharambe and I worked together on AI skills to work with the power-grid-model packages.

It includes 2 skills, 1. pgm-assistant that acts as a pair-programmer to help solve solutions. 2. pgm-issue-analysis is a step by step workflow the AI can follow to uncover a problem you or a user faces.

This pull request adds a reference to the Power-Grid-Model-AI repository hosting the skills to work with the power-grid-model packages.

Made possible by Bright Cubes

@mgovers

mgovers commented Jun 24, 2026

Copy link
Copy Markdown
Member

please set up the DCO (you may want to --amend your commit message and force-push)

Comment thread README.md Outdated
[power-grid-model-io](https://github.com/PowerGridModel/power-grid-model-io) repository.
For an extended python interface to the the power-grid-model, refer to the
[power-grid-model-ds](https://github.com/PowerGridModel/power-grid-model-ds) repository.
**New**: For AI agent skills to work with the power-grid-model ecosystem, refer to the

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Docs easily get outdated and at some point, this may no longer be "new" 😬

Suggested change
**New**: For AI agent skills to work with the power-grid-model ecosystem, refer to the
For AI agent skills to work with the power-grid-model ecosystem, refer to the

I also would recommend not to add it here but to add a section similar to a show-and-tell. You can then write here that "people may also want to have a look at..."

After that is added, maybe SOPTIM wants to add their CIM/CGMES converter (not pinging them yet because it's still draft but maybe something for the coming community meeting @nitbharambe @figueroa1395 )

@Cing2
Cing2 force-pushed the feature/doc_ai_skill branch 2 times, most recently from 1001a3c to dae521b Compare June 24, 2026 14:54
@mgovers

mgovers commented Jul 9, 2026

Copy link
Copy Markdown
Member

@Cing2 we are setting up verified/signed commits and will enforce this shortly. Please set it up before pushing follow-up commits.

Signed-off-by: Camiel Oerlemans <camiel.oerlemans@brightcubes.nl>
@Cing2
Cing2 force-pushed the feature/doc_ai_skill branch from 2d1c9a5 to 5b68621 Compare July 20, 2026 08:52
@Cing2
Cing2 requested a review from mgovers July 20, 2026 08:54
Comment thread README.md
Comment on lines +82 to +89
## Community projects

The following are community-maintained projects built on top of Power Grid Model.
These are not officially maintained by the Power Grid Model project.

* [power-grid-model-ai](https://github.com/BrightCubes/power-grid-model-ai) — AI agent skills for working with the power-grid-model ecosystem.
These skills help coding agents run complete PGM workflows — loading and converting grid data, performing power flow, state estimation and short-circuit calculations, and validating results.
They can also help you debug failures or errors by diagnosing the issue and producing a minimal reproducible case.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@Jonasvdbo pinging you because of the higher-level implications

  • do you think this is good for the time being (given the pending transfer to the PGM org as well as the work on trusted suppliers)?
  • or should this be a completely separate page with a reference from the readme to there?
  • and can we already merge this or do we need to add a couple more such known external public projects?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

@mgovers Thanks for looping me in.

My preference would be to create a dedicated page on the technical documentation site that provides an overview of Power Grid Model community projects, rather than adding this information directly to the README.md. The README could then simply include a reference to that page. To me, that feels like a more natural and maintainable place for this type of content.

Before making a decision, it would be good to discuss this in tomorrow’s PGM TSC.

Also, if we decide to maintain such an overview, I think it would be valuable to make it as complete as reasonably possible and include all community projects we are aware of, rather than maintaining a selective list.

@TonyXiang8787 TonyXiang8787 added the do-not-merge This should not be merged label Jul 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

do-not-merge This should not be merged

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants