<div dir="ltr">Hey,<div><br></div><div>This sounds great. If the SKILL.md file is maintained in the postgis repository, it would be easy for us to include it in pg-aiguide as well. Happy to share our best practices on a call or review/give feedback on a PR if any of that would be helpful.</div><div><br></div><div>Thanks,</div><div>Mat</div></div><br><div class="gmail_quote gmail_quote_container"><div dir="ltr" class="gmail_attr">On Tue, Nov 25, 2025 at 9:01 PM Darafei "Komяpa" Praliaskouski <<a href="mailto:me@komzpa.net">me@komzpa.net</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi,<br><br>Sounds good. I guess we're at a time when everyone tries to collect their own library for AGENTS.md :)<br><br>A list of things we put together for Kontur's systems, fixing stuff actually done wrong by LLMs one at a time:<br><a href="https://github.com/konturio/AGENTS.md/blob/main/AGENTS.raw.md" target="_blank">https://github.com/konturio/AGENTS.md/blob/main/AGENTS.raw.md</a><br><br>What I also learned is that while LLM is randomly forgetful about these spaced repetition helps keep the model's attention on them.<br>For small lists like ours I made a simple trigram based one,<br><a href="https://github.com/konturio/AGENTS.md/blob/main/scripts/spaced_repetition.py" target="_blank">https://github.com/konturio/AGENTS.md/blob/main/scripts/spaced_repetition.py</a><br><br>LLMs write okay-ish PostGIS SQL. Where they currently totally break is h3, as the library changed all the function names<br>on v3 to v4 migration, and there are subtle name differences across different versions. A skill will be more helpful there.<br><br>Maybe we can start SKILL.md in postgis repo so that whoever wants to drop it into their AI and generate less-wrong, more-blessed code with typical user error types corrected?<br>We're already building a cheatsheet but some common mistakes can be listed to un-learn them at LLMs.<br><br>I'll be happy to start and maintain this doc, I'm already doing this anyway for my use cases.<br><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Nov 25, 2025 at 9:50 PM Mat Arye <<a href="mailto:mat%2Bpostgis@tigerdata.com" target="_blank">mat+postgis@tigerdata.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div style="margin:0px;min-width:0px;padding:0px 0px 20px;width:auto;font-family:"Google Sans",Roboto,RobotoDraft,Helvetica,Arial,sans-serif;font-size:medium"><div><div id="m_5587635284171579977m_5076277805122284946gmail-:1yo" style="direction:ltr;margin:8px 0px 0px;padding:0px;font-size:0.875rem;overflow-x:hidden"><div id="m_5587635284171579977m_5076277805122284946gmail-:1oz" style="direction:ltr;font-variant-numeric:normal;font-variant-east-asian:normal;font-variant-alternates:normal;font-size-adjust:none;font-kerning:auto;font-feature-settings:normal;font-stretch:normal;font-size:small;line-height:1.5;font-family:Arial,Helvetica,sans-serif;overflow:auto hidden"><div id="m_5587635284171579977m_5076277805122284946gmail-avWBGd-243"><div dir="ltr"><p>Hi All,</p><p>We've started a new open-source project at Tiger Data aimed at helping AI agents generate higher-quality Postgres code: <a rel="noopener" href="https://github.com/timescale/pg-aiguide" target="_blank">https://github.com/timescale/pg-aiguide<span aria-hidden="true"></span></a><br>For broader context, here’s the announcement blog describing the approach and motivations:<br><a rel="noopener" href="https://www.tigerdata.com/blog/we-taught-ai-to-write-real-postgres-code-open-sourced-it" target="_blank">https://www.tigerdata.com/blog/we-taught-ai-to-write-real-postgres-code-open-sourced-it<span aria-hidden="true"></span></a></p><p>As part of this work, we're adding guidance modules for major Postgres extensions, and PostGIS is at the top of our list. I’m reaching out to ask whether anyone from the PostGIS community would be interested in collaborating.</p><p>The core idea is to provide “skills” that capture best practices, common pitfalls, and domain-specific patterns so that AI agents can make better decisions. Here is an example skill:<br><a rel="noopener" href="https://github.com/timescale/pg-aiguide/blob/main/skills/design-postgres-tables/SKILL.md" target="_blank">https://github.com/timescale/pg-aiguide/blob/main/skills/design-postgres-tables/SKILL.md<span aria-hidden="true"></span></a></p><p>If there’s interest, we’d be happy to set up a call to walk through the approach and answer questions.</p><p>Beyond skills, the project also includes semantic search over documentation. We currently index Postgres and TimescaleDB docs, and we plan to include the PostGIS manual as well. We can handle the processing, but wanted to check whether there’s anything unusual about the HTML manual that we should be aware of. We’d also appreciate any guidance on which versions of the manual are most important to index.</p><p></p><p>Thanks for your time, and we’d welcome any feedback or involvement from the community.</p></div><div></div><div></div></div></div></div><div id="m_5587635284171579977m_5076277805122284946gmail-avWBGd-244" style="clear:both"></div></div></div><br></div>
</blockquote></div>
</blockquote></div>