Agent skill

Ideogram Reference Architecture

by jeremylongshore in jeremylongshore/tons-of-skills-marketplace

Design an Ideogram service boundary with policy gateway, queue, async state, verified webhooks, polling, moderation, storage, and audit.

MITAuto-check passedBackend & APIs

Install Ideogram Reference Architecture

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-reference-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace ideogram-reference-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/.curated/ideogram-reference-architecture .claude/skills/ideogram-reference-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ideogram-reference-architecture
GitHub stars
2.8k
Token cost
~1.1k tokens
SKILL.md length
486 words
Files
2 (incl. references)
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Design an Ideogram service boundary with policy gateway, queue, async state, verified webhooks, polling, moderation, storage, and audit.

  • Works in 7 steps: Define ingress and policy gateway… → Route accepted work to a durable queue… → Use a vendor adapter that owns endpoint… → …
  • Reviewing a production architecture
  • SKILL.md covers Overview, Prerequisites, Current Contract and Authentication, plus 8 more sections
  • Needs IDEOGRAM_API_KEY

What it does

Ideogram Reference Architecture is an agent skill from jeremylongshore/tons-of-skills-marketplace. Design an Ideogram service boundary with policy gateway, queue, async state, verified webhooks, polling, moderation, storage, and audit. Use when creating or reviewing a production architecture. Trigger with "architect Ideogram", "design an Ideogram service", or "review an Ideogram system diagram".

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/official-docs.md`). Compatibility notes: Designed for Claude Code; architecture work is evidence-led and deployment-neutral

It sits in Backend & APIs, covering Webhooks and Microservices. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Reviewing a production architecture
  • With architect Ideogram
  • Design an Ideogram service
  • Review an Ideogram system diagram

Example prompts

  • “architect Ideogram”
  • “design an Ideogram service”
  • “review an Ideogram system diagram”
  • “/ideogram-reference-architecture”

Requirements

  • A credential in IDEOGRAM_API_KEY
  • Compatibility (from SKILL.md): Designed for Claude Code; architecture work is evidence-led and deployment-neutral
  • Pre-approved tools (allowed-tools): Read, Glob, Grep, Write, Edit

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Define ingress and policy gateway boundaries for identity, tenant, rights, media validation, safety, copyright settings, budget, and…
  2. Route accepted work to a durable queue and an account-level concurrency controller.
  3. Use a vendor adapter that owns endpoint schemas, multipart, deadlines, typed errors, and content-free telemetry.
  4. Persist request and generation_id state before async delivery, then reconcile verified webhooks with polling.
  5. Pass safe outputs through a downloader that validates media and stores opaque tenant-scoped objects immediately.
  6. Publish only from the application object store after required review; never authorize from a vendor URL.
  7. Add outbox, audit, deletion, incident, canary, and rollback paths with explicit owners.

What it can do on your machine

Read from SKILL.md and the folder at commit 80f86df. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Glob
    • Grep
    • Write
    • Edit

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • IDEOGRAM_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Claude Code; architecture work is evidence-led and deployment-neutral

    From compatibility in the SKILL.md frontmatter.

Context cost

Ideogram Reference Architecture loads about 1.1k tokens when it runs, and up to ~1.8k if it reads all its reference files. Until then it costs about 83 tokens; SKILL.md has 486 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~83
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit 80f86df, republished under its MIT licence (© jeremylongshore). 486 words, ~1,146 tokens.

Download SKILL.mdSave it as .claude/skills/ideogram-reference-architecture/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
ideogram-reference-architecture
description
Design an Ideogram service boundary with policy gateway, queue, async state, verified webhooks, polling, moderation, storage, and audit. Use when creating or reviewing a production architecture. Trigger with "architect Ideogram", "design an Ideogram service", or "review an Ideogram system diagram".
allowed-tools
Read, Glob, Grep, Write, Edit
compatibility
Designed for Claude Code; architecture work is evidence-led and deployment-neutral
argument-hint
<workload> <tenant-model> <slo>
version
1.11.0
license
MIT
author
Jeremy Longshore <jeremy@intentsolutions.io>
tags
saas, ideogram, architecture
model
inherit
effort
high

Ideogram Reference Architecture

Overview

Define ownership and data flow for a production Ideogram integration. Keep user authorization, paid vendor authority, request validation, async state, event verification, content review, durable media, and audit evidence as explicit components.

Prerequisites

  • Workload, tenant and identity model, data class, SLO, budget, region, and retention policy.
  • Expected endpoint mix, input sizes, concurrency, publication destinations, and failure modes.
  • Owners for billing, security, moderation, storage, operations, and vendor escalation.

Current Contract

The API uses server-side Api-Key, endpoint-specific multipart requests, sync and async generation, item-level safety, signed async webhooks, polling, and temporary asset URLs. Default capacity is 10 in-flight requests. These contracts require stateful application orchestration even when the product experience is synchronous.

Authentication

Place IDEOGRAM_API_KEY only in a private vendor adapter. The policy gateway authenticates application identities and authorizes tenant, use case, spend, input, output, and destination separately.

Instructions

  1. Define ingress and policy gateway boundaries for identity, tenant, rights, media validation, safety, copyright settings, budget, and admission.
  2. Route accepted work to a durable queue and an account-level concurrency controller.
  3. Use a vendor adapter that owns endpoint schemas, multipart, deadlines, typed errors, and content-free telemetry.
  4. Persist request and generation_id state before async delivery, then reconcile verified webhooks with polling.
  5. Pass safe outputs through a downloader that validates media and stores opaque tenant-scoped objects immediately.
  6. Publish only from the application object store after required review; never authorize from a vendor URL.
  7. Add outbox, audit, deletion, incident, canary, and rollback paths with explicit owners.

Tool Discipline

Use Read, Glob, and Grep to ground the design in the actual repository and infrastructure. Use Write and Edit for approved architecture records or implementation. Do not provision services, create keys, or deploy from a design invocation.

Show full SKILL.md (197 more words)Show less

Approval Boundaries

Require accountable review for trust-boundary changes, public ingress, data residency, sensitive media, external publication, retention, spend, and production topology. Record unresolved assumptions as blockers.

Error Handling

  • Keep queue acceptance distinct from vendor acceptance and durable asset completion.
  • Reconcile duplicate or missing events without duplicate paid submissions.
  • Quarantine unsafe, malformed, oversized, or tenant-mismatched media before publication.

Output

Return components, flows, trust boundaries, state model, endpoint choices, SLO and capacity model, data lifecycle, controls, owners, failure paths, open decisions, and rollback architecture. Exclude secret or content examples.

Examples

  • Flow: application client -> policy gateway -> queue -> vendor adapter -> state store -> verified webhook or poller -> safe downloader -> object store -> reviewer -> publisher.
  • Keep audit records content-free while placing regulated media in its approved retention boundary.

Validation

Walk happy, unsafe, throttled, duplicate, missing-webhook, expired-URL, storage-failure, and rollback scenarios. Verify every state and retained datum has one owner and deletion path.

Resources

  • Current first-party evidence map — use the dated endpoint, webhook, billing, team, and training links as the contract index for this workflow.
  • Recheck the endpoint-specific page and current OpenAPI description before relying on an enum, limit, beta feature, or lifecycle claim.
  • Record live observations as environment-specific evidence, not as universal vendor guarantees.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in skills/.curated/ideogram-reference-architecture of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • references/official-docs.md

Open the folder on GitHubat commit 80f86df

Compare with similar skills

Ideogram Reference Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ideogram Reference Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ideogram Reference Architecture this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.1kAutomated safety check: PassMIT
CalendlyCraftOS-dev/CraftBot3921 repos~5.7kAutomated safety check: PassMIT
ClickupCraftOS-dev/CraftBot3921 repos~5.1kAutomated safety check: PassMIT
ClickfunnelsLeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT
MailgunLeoYeAI/openclaw-master-skills2.2k—~4.5kAutomated safety check: PassMIT
AsanaCraftOS-dev/CraftBot392—~4kAutomated safety check: PassMIT

Similar skills

  • Calendly

    CraftOS-dev/CraftBot

    Calendly API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub starsUsed in 1 repo~5.7k tokens
    Backend & APIsAuto-check passed
  • Clickup

    CraftOS-dev/CraftBot

    ClickUp API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub starsUsed in 1 repo~5.1k tokens
    Backend & APIsAuto-check passed
  • Clickfunnels

    LeoYeAI/openclaw-master-skills

    ClickFunnels API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Mailgun

    LeoYeAI/openclaw-master-skills

    Mailgun API integration with managed OAuth. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub stars~4.5k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Asana

    CraftOS-dev/CraftBot

    Asana API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~4k tokensUpdated today
    Backend & APIsAuto-check passed
  • Fathom

    CraftOS-dev/CraftBot

    Fathom API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~3.7k tokensUpdated today
    Backend & APIsAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Categories

Questions about Ideogram Reference Architecture

What does Ideogram Reference Architecture do?

Design an Ideogram service boundary with policy gateway, queue, async state, verified webhooks, polling, moderation, storage, and audit. Ideogram Reference Architecture is an agent skill from jeremylongshore/tons-of-skills-marketplace. Design an Ideogram service boundary with policy gateway, queue, async state, verified webhooks, polling, moderation, storage, and audit.

When should I use Ideogram Reference Architecture?

Ideogram Reference Architecture fits situations like: reviewing a production architecture; with architect Ideogram; design an Ideogram service; review an Ideogram system diagram.

How do I install Ideogram Reference Architecture in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-reference-architecture -a claude-code`. Or copy the skill folder (skills/.curated/ideogram-reference-architecture in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/ideogram-reference-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Ideogram Reference Architecture in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-reference-architecture -a codex`. Or copy the skill folder (skills/.curated/ideogram-reference-architecture in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/ideogram-reference-architecture in your project. Codex loads it when a task matches its description.

Can I use Ideogram Reference Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill ideogram-reference-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ideogram-reference-architecture, .gemini/skills/ideogram-reference-architecture, .github/skills/ideogram-reference-architecture and .opencode/skills/ideogram-reference-architecture in your project.

What does Ideogram Reference Architecture need to run?

Going by SKILL.md and its folder, Ideogram Reference Architecture needs credentials named IDEOGRAM_API_KEY. Our summary lists: A credential in IDEOGRAM_API_KEY. Its frontmatter pre-approves these tools: Read, Glob, Grep, Write, Edit. Compatibility (from SKILL.md): Designed for Claude Code; architecture work is evidence-led and deployment-neutral.

Does Ideogram Reference Architecture access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ideogram Reference Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Ideogram Reference Architecture use?

Ideogram Reference Architecture is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ideogram Reference Architecture use?

About 1.1k tokens (SKILL.md is roughly 4.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 620 tokens, read only when the agent opens those files.

What are the alternatives to Ideogram Reference Architecture?

Skills that share tags, products or a category with Ideogram Reference Architecture: Calendly (CraftOS-dev/CraftBot, 392 stars), Clickup (CraftOS-dev/CraftBot, 392 stars), Clickfunnels (LeoYeAI/openclaw-master-skills, 2.2k stars) and Mailgun (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ideogram Reference Architecture?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,825 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 9, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.