Install
python3 "$SKILL_ROOT/scripts/fireworks.py" version누구에게 맞나
아키텍처나 흐름을 자연어로 설명하고, 기하 검증된 SVG와 고해상도 PNG를 받고 싶다면 이 Agent Skill이 더 맞다. 같은 스킬은 Codex와 Claude Code에서 고치지 않고 쓸 수 있다. 검증된 SVG를 GIF 의미 애니메이션으로 바꾸거나, 오프라인 대화형 HTML도 만들 수 있다.
이미 위 코딩 어시스턴트에서 이 스킬을 호출할 수 있어야 하고, 로컬에 python3가 있으며 $SKILL_ROOT/scripts/fireworks.py를 찾을 수 있어야 한다. 손으로만 그리고 Agent가 디스크에 쓰게 할 생각이 없는 사람에게는 이득이 적다. 페이지가 지명하는 클라이언트는 Codex와 Claude Code뿐이며 다른 클라이언트는 적혀 있지 않다. 저장소 제목의 더 오래됐을 수 있는 스타일 개수로 본문의 생성기 스타일 11개와 AI 작성 스타일 1개(Dark Luxury)를 덮지 마라.
3분 만에 첫 시도 마치기
페이지는 별도의 마켓 설치 명령을 주지 않는다. 먼저 읽기 전용 확인: 스킬 루트가 이미 준비돼 있을 때 실행한다.
python3 "$SKILL_ROOT/scripts/fireworks.py" version
성공 신호는 명령이 통과하고 버전 정보를 내는 것이다. 그림 파일은 쓰지 않는다. $SKILL_ROOT가 아직 없으면 먼저 멈춰라. 확보된 페이지 본문은 스킬을 Codex나 Claude Code에 넣는 방법을 쓰지 않았다. 설치기를 스스로 보태지 마라.
버전이 통과한 뒤, 통제된 출력 한 번을 한다. 공식 예는 사용자가 “Generate a Mem0 memory architecture diagram, dark style”라고 말하는 것이다. 스킬은 Memory Architecture Diagram, Style 2로 분류하고, 스윔레인·원기둥·의미 화살표가 있는 SVG를 만든 뒤 1920px PNG를 내보내며 mem0-architecture.svg / mem0-architecture.png를 보고한다. 파일을 쓰기 전에 Agent에게 이 두 경로를 다시 말하게 하고, 당신이 확인한 뒤에 생성하라. 처음부터 GIF나 HTML을 하지 마라. 확보된 페이지 본문은 그 산출물을 언급하지만 대응 서브커맨드는 없다.
사용 사례
사례 1: 자연어로 아키텍처 다이어그램 내기. 위의 Mem0 예로 전체 사슬을 검증하라: 분류 → SVG → 1920px PNG → 파일 이름 보고. Style 2의 시각 파라미터 전부도, Mem0 도메인 지식의 출처도 적혀 있지 않다. 따라서 확인은 분류 결과가 말해지고 그 두 파일 이름이 보고에 나오는지만 본다. Agent가 업무 코드를 고치기 시작하면 이미 그림 작업을 떠난 것이다.
사례 2: 기존 SVG에서 PNG 내보내기. 공식 CLI는
python3 "$SKILL_ROOT/scripts/fireworks.py" export-png diagram.svg diagram.png --width 1920
이것은 diagram.png를 덮어쓰거나 새로 만든다. 입력 SVG가 있는지, 출력 경로에 쓸 수 있는지 먼저 확인하라. 글자가 잘리지 않게 하려면 설정에 "text_policy": "strict"를 넣는다. 쓰기 전에 보이는 잘림을 거부하고, 보고에 완전한 원본 라벨을 남기며 복구 방법을 설명한다. 중국어 설명은 사용 가능한 둘째 줄을 쓴다. 확보된 페이지 본문은 완전한 JSON 파일 이름을 주지 않는다. 이 필드와 중국어 둘째 줄이 있는지만 확인하고, 다른 정책 값을 만들지 마라.
사용 경계
스타일 개수는 본문을 따른다: 생성기 스타일 11개, 더해 Dark Luxury. 또 공학 성향 스타일 네 종류가 있어 C4 리뷰, 클라우드 배포, 이벤트 스트림, 신뢰성 점검을 위한 실행 가능한 약속을 주고, 깊은 AI/Agent 도메인 패턴과 UML 다이어그램 14종 전부를 제공한다. 페이지는 UML 14종의 이름도, 그 네 공학 스타일의 짧은 이름도 적지 않았다. 이름이 없으면 지명해 호출하지 마라.
복사 가능한 명령은 version과 export-png뿐이다. GIF와 대화형 HTML은 능력으로 적혀 있지만 명령줄은 없다. 두 번째 설치기를 나란히 두지 마라. 클라이언트는 Codex와 Claude Code까지만 적혀 있다.
처음은 version, 또는 경로를 확인한 PNG 한 장에서 멈춘다. 일괄 출력, text_policy 이외의 알 수 없는 필드 변경, GIF/HTML 생성은 먼저 Agent에게 근거와 쓸 파일을 말하게 하고 당신이 확인한 뒤에 계속한다.