setting-profile-images SKILL.md skillA

setting-profile-images from letta-ai/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add letta-ai/skills/setting-profile-images@git:20260615.0d50d92

Pins git:20260615.0d50d92 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
letta-ai/skills
Path
letta/setting-profile-images/SKILL.md
Versions recorded
1
Latest version
git:20260615.0d50d92, committed Jun 15, 2026
Size
2,560 bytes
Repository stars
152
License
a license file GitHub does not identify

Sets Letta Desktop and Letta Code agent profile images by writing profile.png into an agent MemFS repository. Use when the user asks to add, change, generate, or fix an agent avatar, profile picture, profile image, or Desktop agent photo.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Setting Profile Images

## Key fact

Letta Desktop displays an agent profile image from the agent memory repository at:

```text
$MEMORY_DIR/profile.png
```

The Desktop/local backend API reads the same file via:

```text
GET /v1/agents/:agent_id/profile-picture
```

For local Desktop agents, do **not** PATCH arbitrary agent metadata for the avatar. Write `profile.png` into MemFS and commit it.

## Workflow

1. Obtain an image:
   - Use a user-provided image path, or
   - Generate/create an avatar image with another image/art skill, then save it locally.
2. Convert/crop it to a square PNG using `scripts/set_profile_image.py`.
3. Commit the resulting `profile.png` to the target agent's memory repo.
4. Verify via the profile-picture endpoint when `LETTA_BASE_URL` and `LETTA_API_KEY` are available.
5. Tell the user to reload/reopen the agent profile in Desktop if the old image is cached.

## Current agent quick start

Locate this skill's script if needed:

```bash
SCRIPT=$(find ~/letta/skills ~/.letta/skills -path '*/setting-profile-images/scripts/set_profile_image.py' -print -quit)
```

Set the current agent's profile image:

```bash
python3 "$SCRIPT" /path/to/avatar.png
```
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add letta-ai/skills/setting-profile-images@sha256:eeb2682f3bfd578e

The line at the top of this page pins the label git:20260615.0d50d92, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_ddk7riaxadl3urwp.svg)](https://markdownregistry.com/a/art_ddk7riaxadl3urwp)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Jun 15, 2026.

versioncommittedcommitsizeaudit
git:20260615.0d50d92 latest2026-06-15 0d50d92 2,560 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2560 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

letta-ai/skills · 152 stars · license a license file GitHub does not identify · pushed 2026-10-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ddk7riaxadl3urwp
GET https://markdownregistry.com/api/v1/resolve?ref=letta-ai/skills/setting-profile-images
GET https://markdownregistry.com/api/v1/blob/eeb2682f3bfd578e07694c01a527eacf00987d8e1b51d3141fb12a9d04fa119a

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from letta-ai/skills

letta-development-guide SKILL.md skill
letta-ai/skills · letta/agent-development/SKILL.md · Comprehensive guide for developing Letta agents, including architecture selection, memory design, model selection, and…
git:20260121.078e325 · audit A · 152 stars
Letta Conversations API SKILL.md skill
letta-ai/skills · letta/conversations/SKILL.md · Guide for using the Letta Conversations API to manage isolated message threads on agents. Use when building multi-user…
git:20260109.6063a75 · audit A · 152 stars
creating-letta-code-channels SKILL.md skill
letta-ai/skills · letta/creating-letta-code-channels/SKILL.md · Builds and debugs Letta Code channels, including first-party channel adapters and dynamic user channel plugins under…
git:20261001.24a73a6 · audit A · 152 stars
letta-fleet-management SKILL.md skill
letta-ai/skills · letta/fleet-management/SKILL.md · Manage Letta AI agent fleets declaratively with kubectl-style CLI. Use when creating, updating, or managing multiple…
git:20260221.84f73cd · audit A · 152 stars
importing-chatgpt-memory SKILL.md skill
letta-ai/skills · letta/importing-chatgpt-memory/SKILL.md · Clone ChatGPT saved memory into Letta, then optionally enrich it with broader conversation history. Designed for a…
git:20260408.2bc2414 · audit A · 152 stars
letta-configuration SKILL.md skill
letta-ai/skills · letta/letta-configuration/SKILL.md · Configure LLM models and providers for Letta agents and servers. Use when setting model handles, adjusting…
git:20260204.eba0c2a · audit A · 152 stars
letta-filesystem-to-memfs SKILL.md skill
letta-ai/skills · letta/letta-filesystem-to-memfs/SKILL.md · Migrates deprecated Letta Filesystem folders/files to MemFS using markdown document corpora, chunking, local lexical…
git:20260513.aeb5473 · audit A · 152 stars
navigating-chatgpt-history SKILL.md skill
letta-ai/skills · letta/navigating-chatgpt-history/SKILL.md · Navigates archived ChatGPT or Claude-style conversation exports and a MemFS reference archive on demand. Use when…
git:20260521.b7217b9 · audit A · 152 stars
self-configuration SKILL.md skill
letta-ai/skills · letta/self-configuration/SKILL.md · Configures Letta agents' own runtime behavior, including model, context window, system prompt, reasoning, conversation…
git:20260618.9da3d97 · audit A · 152 stars
skill-development SKILL.md skill
letta-ai/skills · meta/skill-development/SKILL.md · Create and contribute skills to the communal knowledge base. Use when creating new skills, updating existing skills, or…
git:20260204.eba0c2a · audit A · 152 stars
1password SKILL.md skill
letta-ai/skills · tools/1password/SKILL.md · Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or…
git:20260422.af6a950 · audit A · 152 stars
ai-news SKILL.md skill
letta-ai/skills · tools/ai-news/SKILL.md · Fetch and summarize recent AI news from curated RSS feeds (Hugging Face, VentureBeat, The Verge, OpenAI, Anthropic…
git:20260316.2512e61 · audit A · 152 stars

Every file in letta-ai/skills

Browse by kind, by grade A, or by owner.