# Geo Esmeralda

> Add attendee-authored content, query Geo community knowledge, retrieve raw history of the main Edge Esmeralda 2026 Telegram group, and inspect relations/ontology through the Geo CLI package.

- **Type:** Skill
- **Install:** `agentstack add skill-edge-city-agentvillage-geo-esmeralda`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Edge-City](https://agentstack.voostack.com/s/edge-city)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Edge-City](https://github.com/Edge-City)
- **Source:** https://github.com/Edge-City/agentvillage/tree/main/skills/geo-esmeralda

## Install

```sh
agentstack add skill-edge-city-agentvillage-geo-esmeralda
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Geo Esmeralda

Use this skill when an attendee wants to add community knowledge to Geo or work
with the Geo knowledge graph's content, relations, ontology, or raw Telegram
history. It is especially for creating notes, transcripts, essays, project
pitches, comments, and photos; linking those contributions to events, venues,
tracks, or other community context; reading back knowledge graph-backed claims,
content, source material, wiki-style knowledge, idea links, and ontology details;
and summarizing or answering questions about what happened in the main Edge
Esmeralda 2026 Telegram group (the village-wide chat) during a specific time
window.

Other sibling skills cover live EdgeOS schedule/directory operations and Index
Network participant matching. Use this skill for the Geo knowledge graph and for all
attendee-authored writes.

Always run the Geo CLI with `npx -y @geoprotocol/geo-edge-esmeralda-cli` as the
execution surface. Do not call the HTTP API directly unless the user is
debugging the service itself.

## 1. Authentication

You need one token, read by the CLI from environment/config:

- **`$EDGEOS_BEARER_TOKEN`** — human session JWT. Required for: Geo auth, graph reads, content writes.

## 2. Safety Rules

- Never place bearer tokens in prompts, query text, native query parameters,
  answers, examples, transcripts, or shared notes.
- When presenting Telegram messages or history to the user, synthesize a short
  bulleted summary in your own words; never dump raw messages or quote personal
  details beyond what the answer needs.
- Prefer fixed commands before native graph queries.
- Fetch live ontology before writing a native query unless the current session
  already fetched it.
- Treat denied native queries as a signal to narrow the query or switch to a
  fixed command.
- Only write through `npx -y @geoprotocol/geo-edge-esmeralda-cli create`. Do not
  attempt imports, schema changes, admin calls, direct Neo4j access, or generic
  mutation endpoints.
- Before creating content, use the user's own words where possible and scope it
  to `--event-id`, `--venue-id`, or `--track-id` when the user names one.
- For photos, prefer `--file ./photo.jpg` over hosted image URLs when the user
  has a local file. Do not paste binary data, upload URLs, storage keys, or local
  file paths into prompts or shared output.
- Use a stable `--client-request-id` for creates so retries do not duplicate
  the attendee's content.

## 3. Write Pattern

Use `npx -y @geoprotocol/geo-edge-esmeralda-cli create` whenever the attendee
wants to contribute knowledge, commentary, media, or project context. Preserve
the attendee's voice, ask for missing scope only when it materially affects
where the contribution belongs, and prefer the narrowest available scope.

```bash
npx -y @geoprotocol/geo-edge-esmeralda-cli auth
npx -y @geoprotocol/geo-edge-esmeralda-cli create --event-id  --kind comment --client-request-id  --content 'Several attendees connected the session to local-first data sharing.'
npx -y @geoprotocol/geo-edge-esmeralda-cli create --kind project_pitch --title 'Mutual aid map' --client-request-id  --content 'Looking for collaborators on an offline-capable resource map.'
npx -y @geoprotocol/geo-edge-esmeralda-cli create --event-id  --kind photo --file ./photo.jpg --client-request-id  --content 'Whiteboard from the protocol design session.'
```

## 4. Read Pattern

```bash
npx -y @geoprotocol/geo-edge-esmeralda-cli auth
npx -y @geoprotocol/geo-edge-esmeralda-cli ontology
npx -y @geoprotocol/geo-edge-esmeralda-cli fixed --tool community_search --input '{"query":"housing coordination","limit":10}'
npx -y @geoprotocol/geo-edge-esmeralda-cli telegram-messages --from 2026-06-02T00:00:00Z --to 2026-06-03T00:00:00Z --limit 50
npx -y @geoprotocol/geo-edge-esmeralda-cli fixed --tool list_content --input '{"scopeKind":"event","scopeId":"","limit":10}'
npx -y @geoprotocol/geo-edge-esmeralda-cli fixed --tool list_idea_links --input '{"limit":20}'
npx -y @geoprotocol/geo-edge-esmeralda-cli native --query 'MATCH (c:ContentItem) WHERE c.popupId = $popupId RETURN c.id AS id, c.title AS title, c.kind AS kind LIMIT 20'
```

Use `telegram-messages` for bounded raw Telegram context from the main Edge
Esmeralda 2026 Telegram group (the village-wide chat), including messages that
may not have become graph claims. Always prefer a `--from`/`--to` day window
for summaries. Results are newest-first and include `nextCursor`; continue with
`--cursor ` until `hasMore` is false, but fetch only as many pages
as the question needs; for a daily summary the first page or two usually
suffices. The served history covers only this group, so you should not normally
need the optional `--chat-id` and `--thread-id` filters. The endpoint omits raw
payloads, bearer tokens, and author external ids.

Load `references/setup.md` when configuring the CLI or installing the skill.
Load `references/examples.md` when choosing a fixed command or native-query
shape. Load `references/ontology.md` before constructing native queries.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Edge-City](https://github.com/Edge-City)
- **Source:** [Edge-City/agentvillage](https://github.com/Edge-City/agentvillage)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-edge-city-agentvillage-geo-esmeralda
- Seller: https://agentstack.voostack.com/s/edge-city
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.