Sign in

fkilcommins

@fkilcommins.bsky.social
88 followers 33 following 150 posts

Head of Enterprise Architecture @Jentic, Technology Architect, Husband, Dad, Failed Footballer. Opinions and spelling mistakes are my own! (he / him)

PostsRepliesMedia
fkilcommins @fkilcommins.bsky.social · 25/09/2026
The September edition of "Jentic Tech Talk" from @jentic.bsky.social is out. There's some interesting content especially for those who care about API usage for agentic systems. jentic.com/newsletter/t...
jentic.com
Jentic Tech Talk — September 2026 | Newsletter
The newsletter for teams building AI that actually ships. Covering APIs, AI agents, open standards, and enterprise architecture.
122
Reposted by fkilcommins
API Evangelist @apievangelist.com · 19/09/2026
apievangelist.com
Big City Storytelling: Arazzo
I said in my frontier storytelling post that the moving parts I was cataloging there were not the ones enterprises need to hear. This is the other post. I am...
021
Reposted by fkilcommins
API Evangelist @apievangelist.com · 17/09/2026
apievangelist.com
Arazzo Is Adding SOAP -- Comment on the Pull Request Before the Upcoming Release
I sat in on the Arazzo bi-weekly call this morning, and the first thing on the agenda was a pull request that has been open since July and is, by the maintai...
021
Reposted by fkilcommins
API Evangelist @apievangelist.com · 17/09/2026
OpenAPI, AsyncAPI, JSON Schema, Arazzo, Overlay, Spectral, APIs.json, MCP and A2A — read from their published schemas, mapped by what each one points at, which property does which job, and how much vocabulary they share. standards.apievangelist.com/relationships/
043
fkilcommins @fkilcommins.bsky.social · 17/09/2026
Many integration workflows are a mix of REST and event-driven working in concert. That's exactly why Arazzo 1.1 added AsyncAPI support. Next week I'm joining the #AsyncAPI community to show how #Arazzo and AsyncAPI give agents a machine-readable map of those mixed workflows. 👉 luma.com/zhcf7zvq
luma.com
Making AI Agents Reliable Event-Driven API Consumers with Arazzo · Luma
AI agents are increasingly expected to act across any of your APIs, publishing to a queue, waiting on a webhook, correlating an async response, not just…
121
fkilcommins @fkilcommins.bsky.social · 28/08/2026
Congrats to WSO2 on their revamped agent-ready Developer Portal. Built-in workflow and capability discovery for agents, with first-class #Arazzo support. Good to see a mainstream API mgmt vendor treating it as a core feature. Cool to see they used our oss 𝗮𝗿𝗮𝘇𝘇𝗼-𝘂𝗶 component for the rendering.
142
fkilcommins @fkilcommins.bsky.social · 27/08/2026
The August edition of @jentic.bsky.social "Jentic Tech Talk" is out. If you're building with AI agents or thinking about the API infrastructure underneath them? Worth a read. → jentic.com/newsletter/t...
jentic.com
Jentic Tech Talk — August 2026 | Newsletter
The newsletter for teams building AI that actually ships. Covering APIs, AI agents, open standards, and enterprise architecture.
221
Reposted by fkilcommins
API Evangelist @apievangelist.com · 16/08/2026
apievangelist.com
APIs Are 100x More Important Than Five Years Ago, and Still Uncool
Nobody wants to talk about APIs at a dinner party, and they never will. APIs are plumbing, and plumbing is invisible right up until the moment it fails. I ha...
031
fkilcommins @fkilcommins.bsky.social · 14/08/2026
#APIs are increasingly consumed by AI agents, not humans. Most aren't ready for it. Next Friday at #APIdaysIndia, Erik Wilde and I run a full-day masterclass on building APIs that are safe and predictable for agent consumers. A few seats left in #Bengaluru Register: confengine.com/conferences/...
Building AI-Ready APIs with Agent Skills. A full-day masterclass by Erik Wilde and Frank Kilcommins. 

We cover OpenAPI, Overlays, and Arazzo, the open standards that make APIs work for both human and agent consumers. The same foundations also make for better, more governable MCP tools.
130
fkilcommins @fkilcommins.bsky.social · 13/08/2026
Research from team #Jentic on API Discoverability for AI Agents. We studied 8,467 API operations across 70 real enterprise #OpenAPI docs. - 35% agent retrieval accuracy gain with better descriptions - ~80% reduction in #LLM costs - 57% of APIs miss summary/description jentic.com/report/disco...
210
fkilcommins @fkilcommins.bsky.social · 31/07/2026
Jentic Talk #6 is out. Highlights: full-day workshop at #apidays India together with Erik Wilde - "Building AI-Ready APIs with Agent Skills". Plus "jentic-api-improve" skill has breaking changes mode, API Scorecard CLI updates, arazzo2openapi, and more. jentic.com/newsletter/techtalks/techtalk-06
jentic.com
Jentic Tech Talk — July 2026 | Newsletter
The newsletter for teams building AI that actually ships. Covering APIs, AI agents, open standards, and enterprise architecture.
010
fkilcommins @fkilcommins.bsky.social · 28/07/2026
We just opened a PR to add first-class SOAP support to #Arazzo 1.2 RC from @openapis.org. Millions of enterprise SOAP services will soon be reachable from Arazzo workflow steps. Minimal additive changes as SOAP already runs over HTTP, most of Arazzo already worked. PR: github.com/OAI/Arazzo-S...
github.com
feat(spec): add SOAP support by frankkilcommins · Pull Request #533 · OAI/Arazzo-Specification
Adds first-class WSDL support to Arazzo 1.2 via a minimal, additive set of changes. Because SOAP operates over HTTP, the vast majority of Arazzo already works for SOAP workflows without modificatio...
022
fkilcommins @fkilcommins.bsky.social · 27/07/2026
The @jentic.bsky.social api-improve #agentskill now has a "mode=full" option, which allows breaking changes to be included in the updated Overlay and #OpenAPI. Every breaking change is flagged explicitly in the changelog via #oasdiff and you remain in control. github.com/jentic/jenti...
010
fkilcommins @fkilcommins.bsky.social · 27/07/2026
Heading to India for the first time to speak at #apidays India 2026. Sat down with the @specmatic.bsky.social & apidays teams ahead of the conference to talk #Arazzo, agentic systems, and why most impressive demos don't make it to production. Full interview here 🇮🇳 confengine.com/conferences/...
confengine.com
Speaker Interview with Frank Kilcommins - apidays India 2026
#apidaysindia @apidays team had an opportunity to catch-up with Frank Kilcommins. Checkout the interview and learn more about Frank Kilcommins
010
Reposted by fkilcommins
APIs You Won't Hate @apisyouwonthate.com · 15/07/2026
One of OpenAPI's unsung heroes is its ability to be extended elegantly. You're gonna love @apievangelist.com's article on extensions. Also in this dispatch: Gin, the HTTP framework for Go, Upyo for sending email, Leaf Wiki, and the HTTP OPTIONS method. apisyouwonthate.com/newsletter/e...
apisyouwonthate.com
Extending OpenAPI
One of OpenAPI's unsung heroes is its ability to be extended elegantly. Also in this dispatch: Gin, the HTTP framework for Go, Upyo for sending email, Leaf Wiki, and the HTTP OPTIONS method.
184
fkilcommins @fkilcommins.bsky.social · 07/07/2026
Scoring your API for AI-readiness tells you where you are. But what do you improve, in what order, and how do you know the result is better and non-breaking? Our 𝙟𝙚𝙣𝙩𝙞𝙘-𝙖𝙥𝙞-𝙞𝙢𝙥𝙧𝙤𝙫𝙚 #agentskill does. A Structured loop, non-breaking changes. Three artifacts out: revised spec, Overlay file, changelog.
100
fkilcommins @fkilcommins.bsky.social · 07/07/2026
Just shipped 𝙖𝙥𝙞-𝙞𝙢𝙥𝙧𝙤𝙫𝙚 at @jentic.bsky.social, an #agentskill that scores your @openapis.org doc, plans non-breaking improvements, and outputs a revised #OpenAPI, an #Overlay file, and a human-readable changelog. Constrained to non-breaking changes. Works with Claude Code and Vercel Skills CLI.
120
fkilcommins @fkilcommins.bsky.social · 30/06/2026
The #dotnet ecosystem just got #Arazzo support. Vincent Biret shipped openapi-arazzo-dotnet - parse, build, serialize, validate Arazzo documents. Available as a library, CLI tool, Docker image, and GitHub Action. 🔗 github.com/BinkyLabs/openapi-arazzo-dotnet
github.com
GitHub - BinkyLabs/openapi-arazzo-dotnet: Implementation of the Arazzo specification compatible with Microsoft.OpenAPI in dotnet
Implementation of the Arazzo specification compatible with Microsoft.OpenAPI in dotnet - BinkyLabs/openapi-arazzo-dotnet
100
Reposted by fkilcommins
API Evangelist @apievangelist.com · 29/06/2026
Most of the healthcare APIs I profile describe themselves one endpoint at a time, but nobody actually integrates one endpoint at a time. The real work is a sequence: authenticate, register a patient, kick off a query across the national networks. apievangelist.com/2026/06/29/m...
apievangelist.com
Mapping Particle Health Record Retrieval as Arazzo Workflows
Most of the healthcare APIs I profile describe themselves one endpoint at a time, but nobody actually integrates one endpoint at a time. The real work is a s...
031
fkilcommins @fkilcommins.bsky.social · 25/06/2026
Validity ≠ usability. A conformant #OpenAPI doc tells you nothing about whether an agent can actually use it. That gap is now measurable and directly from inside your coding agent. jentic.com/blog/agent-check-if-your-apis-are-ai-ready
jentic.com
Let Your Agent Check if Your APIs are AI-Ready
Most engineers know the problem: validity and usability aren't the same thing. The Jentic API Scorecard is now a native agent skill for Claude Code.
000
fkilcommins @fkilcommins.bsky.social · 23/06/2026
We've an evergreen home for the Jentic Tech Talk newsletter. Issue05: API AI-Readiness Scorecard now on GitHub Actions. RFC 10008 closes a 25-year HTTP gap. Bryam Vega's Arazzo deep-dive is worth your time. Plus Erik on MCP through the lens of what you've already built. jentic.com/newsletter/t...
jentic.com
Jentic Tech Talk — June 2026 | Newsletter
The newsletter for teams building AI that actually ships. Covering APIs, AI agents, open standards, and enterprise architecture.
000
fkilcommins @fkilcommins.bsky.social · 22/06/2026
We've just shipped an #agentskill for the @jentic.bsky.social API AI-Readiness Scorecard. Your coding agent can score #OpenAPI docs for AI-readiness itself. Claude Code: /𝘱𝘭𝘶𝘨𝘪𝘯 𝘪𝘯𝘴𝘵𝘢𝘭𝘭 𝘢𝘱𝘪-𝘴𝘤𝘰𝘳𝘦𝘤𝘢𝘳𝘥@𝘫𝘦𝘯𝘵𝘪𝘤-𝘢𝘱𝘪-𝘴𝘤𝘰𝘳𝘦𝘤𝘢𝘳𝘥 Vercel: 𝘯𝘱𝘹 𝘴𝘬𝘪𝘭𝘭𝘴 𝘢𝘥𝘥 𝘫𝘦𝘯𝘵𝘪𝘤/𝘫𝘦𝘯𝘵𝘪𝘤-𝘢𝘱𝘪-𝘴𝘤𝘰𝘳𝘦𝘤𝘢𝘳𝘥 2-minute walkthrough 👇
010
fkilcommins @fkilcommins.bsky.social · 19/06/2026
Signal #10 in #TheWeeklySignal series: Structural Integrity An #agent doesn't just parse an #OpenAPI doc, it reasons over it. Structural integrity measures whether the surface shapes and schema model makes agent reasoning and planning possible. Three APIs. Very different answers. 👇
100
fkilcommins @fkilcommins.bsky.social · 18/06/2026
Signal #9 in #TheWeeklySignal series: Complexity Comfort Before an agent calls an API, it plans. The bigger and deeper the surface, the harder that planning problem gets. Three APIs. Very different answers on how navigable their surface actually is. 👇 Powered by: github.com/jentic/jenti...
100
fkilcommins @fkilcommins.bsky.social · 05/06/2026
Signal #8 in #TheWeeklySignal series: Summary Coverage Before processing #OpenAPI parameters, schemas, or examples, an AI agent reads the `summary` field. That one-liner is the operation's headline. Three APIs. Very different answers on whether it exists at all. 👇
100
fkilcommins @fkilcommins.bsky.social · 04/06/2026
We’re launching our free and useful API AI-Readiness CLI tools on ProductHunt today. All feedback welcome. www.producthunt.com/products/api...
producthunt.com
API AI Readiness Scorecard: Is your API ready for AI agents? Get an AI readiness score | Product Hunt
Jentic API Scorecard is a free, open-source CLI and web UI that grades any OpenAPI spec for AI-readiness across six dimensions: compliance, developer experience, agent readiness, usability, security, ...
000
fkilcommins @fkilcommins.bsky.social · 28/05/2026
Signal #7 in #TheWeeklySignal series from @jentic.bsky.social: Example Validity Previously, signal #3 asked: do your APIs have examples? Most don't. This week: the ones that do — are they correct? Three APIs, very different answers. 👇
100
fkilcommins @fkilcommins.bsky.social · 21/05/2026
Signal #6 in #TheWeeklySignal series: Authentication Strength An agent doesn't just need to know auth is required. It needs to understand how to authenticate safely: scoped, renewable, machine-readable. Does your OpenAPI description say enough? Three APIs. Very different answers. 👇
110
fkilcommins @fkilcommins.bsky.social · 20/05/2026
Arazzo Specification v1.1.0 is out from the @openapis.org 🚀 The headline: #AsyncAPI support. For the first time, #Arazzo workflows span both synchronous and async #APIs in a single machine-readable document. 🧵
132
fkilcommins @fkilcommins.bsky.social · 14/05/2026
Signal #5 in #TheWeeklySignal series: Response Coverage When an agent calls your API, it needs to understand what comes back. Three examples, very different results. 👇 This week's question: beyond the success case, how much of your API's response landscape have you actually documented?
100
fkilcommins @fkilcommins.bsky.social · 12/05/2026
As #AI agents gain more capabilities, everyone's paying much closer attention to their API estate. But how do you ensure the #APIs you deliver actually cater for agentic consumers? Here's Erik Wilde's top tip for delivering AI-ready APIs
100
fkilcommins @fkilcommins.bsky.social · 07/05/2026
Signal #4 in #TheWeeklySignal series: OperationId Quality An agent doesn't read paths and infer intent. It looks for operationIds , the stable names tool-calling systems, #Arazzo workflows, and SDK generators depend on. Three APIs. Very different results. 👇
100
fkilcommins @fkilcommins.bsky.social · 06/05/2026
Speaking at #APIDays / Future of Software Technologies NYC next week on: 𝗕𝗲𝘆𝗼𝗻𝗱 𝗢𝗽𝗲𝗻𝗔𝗣𝗜: 𝗪𝗼𝗿𝗸𝗳𝗹𝗼𝘄𝘀 𝗧𝗵𝗮𝘁 𝗔𝗜 𝗔𝗴𝗲𝗻𝘁𝘀 𝗖𝗮𝗻 𝗔𝗰𝘂𝗮𝗹𝗹𝘆 𝗘𝘅𝗲𝗰𝘂𝘁𝗲 I’ll explore Arazzo 1.1.0, including AsyncAPI support. If you’re around NYC and want to chat OpenAPI/Arazzo, or tooling at @jentic.bsky.social, come say hello 👋
111
fkilcommins @fkilcommins.bsky.social · 30/04/2026
Signal #3 in The Weekly Signal series: Example Density A schema tells you the shape. An example shows you what the data actually means. Using @jentic.bsky.social API AI-Readiness Framework Three APIs. Very different results. 👇
100
fkilcommins @fkilcommins.bsky.social · 29/04/2026
It's very nice to be keynoting at APIOps Helsinki on: 𝘼𝙋𝙄𝙊𝙥𝙨 𝙞𝙣 𝙩𝙝𝙚 𝘼𝙜𝙚 𝙤𝙛 𝘼𝙄 𝘼𝙜𝙚𝙣𝙩𝙨 The thesis: If an agent can call APIs, trigger workflows, or decide what to call, then action-layer control is the capability & security boundary, not the prompt. #apiopshelsinki2026 #AIAgents #OpenAPI #Arazzo
010
fkilcommins @fkilcommins.bsky.social · 28/04/2026
Most #APIs weren't designed for autonomous agents. On May 23rd, join Erik & I for a "Designing AI-ready APIs" masterclass. We'll work through the role #OpenAPI, #Overlay & #Arazzo play in improving AI-readiness for APIs. Learn more & Register: www.eventbrite.co.uk/e/designing-...
010
fkilcommins @fkilcommins.bsky.social · 24/04/2026
Signal #2 in The Weekly Signal series: Error Standardisation #RFC9457 First #API interactions rarely start clean. The question isn’t “did it fail?”, it’s, "Did the error tell you enough to recover?" Three APIs. Very different results. 👇
100
fkilcommins @fkilcommins.bsky.social · 22/04/2026
Nice to be part of this @infoworld.bsky.social feature by @doerrfeldbill.bsky.social on building enterprise-grade agentic systems. Hot take: Determine what's adaptive vs. deterministic, and codify the latter. Not everything needs an LLM in the loop. www.infoworld.com/article/4154...
infoworld.com
Best practices for building agentic systems
Which technologies, designs, standards, development approaches, and security practices are gaining momentum in multi-agent enterprise systems? We asked the experts.
031
Reposted by fkilcommins
Bruno Pedro @brunopedro.com · 21/04/2026
"The latest shift in the API landscape signals a profound transformation toward AI-native infrastructure, as I could see from last week’s news, where the traditional boundaries between human developers and autonomous agents are rapidly dissolving." apichangelog.substack.com/p/2026-16
apichangelog.substack.com
Postman + Microsoft, SmartBear Drift Detection, Appdome Risk APIs
The API Changelog issue 2026.16
031
Reposted by fkilcommins
Bill Doerrfeld @doerrfeldbill.bsky.social · 20/04/2026
What actually goes into building enterprise-grade AI agents? My latest for @infoworld.bsky.social explores the emerging best practices behind agentic systems: www.infoworld.com/article/4154...
infoworld.com
Best practices for building agentic systems
Which technologies, designs, standards, development approaches, and security practices are gaining momentum in multi-agent enterprise systems? We asked the experts.
021
fkilcommins @fkilcommins.bsky.social · 21/04/2026
Big milestone for #Arazzo 1.1 - #AsyncAPI support has been merged into the release candidate. Arazzo will soon span @openapis.org and AsyncAPI. One workflow language for multiple API styles. Huge thanks to the community. Just 136 review conversations over 7 months! github.com/OAI/Arazzo-S...
github.com
feat: added support for AsyncAPI v3 by nashjain · Pull Request #367 · OAI/Arazzo-Specification
Added support for AsyncAPI v3 Also cleaned up the spec to make it very clear that step-object can be oneOf openapi-step-object or asyncapi-step-object or workflow-step-object For AsyncAPI we really...
031
Reposted by fkilcommins
Nordic APIs @nordicapis.com · 16/04/2026
How do we bring determinism to AI systems that struggle with context and consistency? The answer lies in well-defined, machine-readable workflows, as Frank Kilcommins explains.
nordicapis.com
Why AI Agents Need Deterministic API Workflows | Nordic APIs |
Arazzo specification enables deterministic API workflows for AI agents, improving reliability, scalability, and agent experience.
011
fkilcommins @fkilcommins.bsky.social · 16/04/2026
Signal #1 in The Weekly Signal series: Description Coverage. Your #API may be perfectly valid. It may also be almost useless to an AI agent. An agent reads your #OpenAPI Description. What it finds there is what it knows. Nothing more. Three APIs. Very different results. 👇
120
fkilcommins @fkilcommins.bsky.social · 15/04/2026
Have you got a problem? An API problem? A generic 400 Bad Request helps no one, not developers, not AI agents. #RFC9457 fixes this. We use it across our @jentic.bsky.social #APIs and just open-sourced reusable schemas + Python/TypeScript packages. #Apache2.0 github.com/jentic/api-problem-details
Using standards for API Errors is better for everyone. Developers, Agents, Ops, everyone!
020
fkilcommins @fkilcommins.bsky.social · 14/04/2026
#LLMs figure things out. But for known capabilities, don't leave business logic to chance. #Arazzo codifies exactly what #agents should do: open standard, precise execution, no vendor lock-in. Discoverability without determinism is just controlled chaos. 👉 nordicapis.com/why-ai-agent... #APIs
nordicapis.com
Why AI Agents Need Deterministic API Workflows | Nordic APIs |
Arazzo specification enables deterministic API workflows for AI agents, improving reliability, scalability, and agent experience.
020
Reposted by fkilcommins
Bruno Pedro @brunopedro.com · 09/04/2026
"A workflow that can't be executed remotely feels like a loss of potential. I mean, you can still trigger it manually, or even execute it periodically. However, there's no way for it to receive programmatic requests from the outside world." apichangelog.substack.com/p/exposing-w...
apichangelog.substack.com
Exposing Workflows as API Operations
Any workflow can be available as an API operation.
011
fkilcommins @fkilcommins.bsky.social · 10/04/2026
Agents are getting more capable. The question now: does it work correctly, safely, predictably — every time? #AgentSkills, #MCP, #Arazzo. Three approaches at different points on the flexibility-to-control spectrum. Join Erik and I April 22nd to learn more. Register 👉 jentic.com/webinar/agen...
000
Reposted by fkilcommins
Bruno Pedro @brunopedro.com · 08/04/2026
"APIs are no longer just passive data pipes, but active, auditable, and intelligent frameworks that bridge the gap between human intent and machine execution." Thanks to @jentic.bsky.social for their support, helping keep an independent API publication alive. apichangelog.substack.com/p/2026-14
apichangelog.substack.com
WSO2 OpenAPI to MCP, Runway $10M Fund, Trivy API Key Leak
The API Changelog issue 2026.14
041
Reposted by fkilcommins
GitKraken @gitkraken.com · 26/03/2026
Your AI agent nearly gets the API workflow right. Nearly. Vague API docs = wrong tool calls, bad arguments, silent failures. Arazzo is the open standard giving agents deterministic, step-by-step execution so "nearly right" becomes "always right." Watch the full talk 👇 youtu.be/XjbsAdREHxA
011
fkilcommins @fkilcommins.bsky.social · 02/04/2026
#Arazzo Editor is live! Build #API workflows with form-based editing + live diagrams. No YAML required (unless you want it). Below, I cover why tooling matters for standards, and how Arazzo fits in the agent-ready orchestration picture. jentic.com/blog/arazzo-editor #OpenAPI @jentic.bsky.social
010