Agent Skills
› xuiltul/animaworks
› image-posting
image-posting
GitHub指导Agent在聊天响应中展示图片，包括自动检测工具结果中的URL/路径，以及使用Markdown语法插入本地或远程图片，并说明截图保存位置和代理限制。
Trigger Scenarios
需要在回复中包含搜索结果或生成的图片
需要展示本地截图或附件
处理包含图片链接的文本响应
Install
npx skills add xuiltul/animaworks --skill image-posting -g -y
SKILL.md
Frontmatter
{
"name": "image-posting",
"description": "채팅 응답에 이미지를 넣어 표시하는 스킬. 도구 결과 URL 감지, Markdown 이미지, assets 경로를 다룬다. Use when: 검색·생성 도구 이미지를 답변에 포함, Markdown으로 이미지 삽입, 첨부 표시가 필요할 때."
}
image-posting — 채팅 응답에 이미지 표시하기
개요
채팅 응답에 이미지를 포함하는 방법은 2가지가 있습니다:
- 도구 결과에서 자동 추출 — 도구 결과에 이미지 URL이나 경로가 포함되면 프레임워크가 자동으로 감지하여 채팅 버블에 표시합니다
- Markdown 이미지 구문 — 응답 텍스트에
을 작성하면 프론트엔드가 렌더링합니다
방법 1: 도구 결과에서 자동 표시
도구(web_search, image_gen 등)를 호출한 결과에 이미지 정보가 포함되어 있으면 프레임워크가 자동으로 채팅 버블에 이미지를 표시합니다. Anima 측에서 특별한 조작은 필요 없습니다.
자동 감지 조건
도구 결과 JSON 내에서 다음이 감지되면 이미지로 처리됩니다:
- 경로 감지:
assets/또는attachments/로 시작하는 경로 →source: generated(신뢰됨) - URL 감지:
https://로 시작하고.png.jpg.jpeg.gif.webp로 끝나는 URL →source: searched(프록시 경유) - 키 감지:
image_url,thumbnail,src,url키의 값에 이미지 URL이 있는 경우
응답당 최대 5장까지 표시됩니다.
검색 이미지의 프록시 제한
외부 URL 이미지는 보안을 위해 프록시를 통해 제공됩니다. 허용 도메인:
cdn.search.brave.comimages.unsplash.comimages.pexels.comupload.wikimedia.org
위 이외의 도메인 URL은 프록시에서 차단됩니다.
방법 2: Markdown 이미지 구문
응답 텍스트에 Markdown 이미지 구문을 직접 작성하여 이미지를 표시합니다.
단축 경로 (권장)
프론트엔드가 자동으로 자신의 Anima 이름으로 API 경로를 보완합니다. 파일명만 작성하면 됩니다:
예시:
스크린샷을 찍었습니다!
전체 경로
명시적으로 API 경로를 작성할 수도 있습니다:
스크린샷 저장 위치
agent-browser 등으로 스크린샷을 촬영할 때는 자신의 attachments 디렉토리에 직접 저장하는 것이 확실합니다:
agent-browser screenshot ~/.animaworks/animas/{자신의_이름}/attachments/screenshot.png
예시 (aoi의 경우):
agent-browser screenshot ~/.animaworks/animas/aoi/attachments/page_screenshot.png
저장 후 응답에 다음을 작성하면 표시됩니다:
~/.animaworks/tmp/attachments/에 저장한 경우에도 폴백으로 표시되지만, 임시 디렉토리이므로 영속성이 보장되지 않습니다.
주의사항
- 다른 Anima의 에셋 경로는 직접 참조할 수 없습니다 (권한 외)
- 외부 URL 직접 링크는 비권장. 허용 도메인 외에는 자동 표시되지 않습니다
- 이미지 생성 도구(generate_fullbody 등)의 결과는 자동 표시되므로 Markdown 구문이 불필요합니다
- 응답당 자동 표시는 최대 5장입니다
Version History
- 140e43b Current 2026-07-25 09:14
