Read-only Effect methods
SkillAI & modelsLets your agent define read-only query methods on Golem agents that can be cached for faster repeated calls.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Read-only Effect methods skill
About this capability
Adds cacheable read-only methods to Effect Golem agents. Use for queries that do not mutate agent state.
What this skill tells your AI
The instructions your AI receives, as published by golemcloud/golem in golem-skills/skills/effect/golem-read-only-method-effect/SKILL.md and read by ahel’s review.
Set readOnly on a method; handlers must remain ordinary Effects and must not mutate state or perform writes.
value: method({ input: {}, success: Schema.Number, readOnly: true })
cached: method({
input: {},
success: Schema.String,
readOnly: { cache: { ttlNanos: 5_000_000_000n } },
})
Whether a read-only result is cached per principal is derived from its input: declare a
PrincipalSchema parameter when the response depends on the caller. A read-only handler without
that declared parameter cannot access the ambient Principal service. Do not mark a method
read-only merely because its return type is immutable.
Signals
- GitHub stars
- 2k
- Forks
- 211
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
golem-read-only-method-effect- Source
- github.com/golemcloud/golem