Communitygithub.com

엑셀 파일 생성, 편집 및 분석

스프레드시트 파일(.xlsx, .xlsm, .csv 등)을 생성, 읽기, 편집, 수정하거나 변환하는 모든 작업에 사용합니다. 사용자가 파일 이름이나 경로를 언급하며 작업을 요청할 때 특히 활성화됩니다.

엑셀 파일 생성, 편집 및 분석란 무엇인가요?

이 스킬은 AI 에이전트가 엑셀 및 기타 스프레드시트 파일을 전문적으로 다룰 수 있게 해줍니다. openpyxl, pandas, markitdown 등 사전 설치된 라이브러리를 활용하여 파일 생성, 데이터 편집, 수식 적용, 서식 지정, 차트 작성, 데이터 정리 및 형식 변환을 수행합니다. 특히 수식이 포함된 파일의 경우 LibreOffice 기반 recalc.py 스크립트를 통해 자동 재계산하여 수식 오류를 검증하며, 오류가 발견되면 수정 후 재검증합니다. 금융 모델링을 위해 색상 코드 규칙(입력값 파랑, 수식 검정 등)과 숫자 형식(통화 $#,##0, 음수 괄호, 백분율 0.0%)을 지원하며, 모든 출력물에 대해 전문적인 폰트 사용과 '제로 수식 오류'를 요구합니다. 이 스킬은 Cursor, Claude Code 등 다양한 AI 에이전트 플랫폼에서 사용 가능하며, 사용자가 스프레드시트 파일을 언급하거나 테이블 형식 데이터 처리가 필요한 모든 상황에 적합합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/xlsx

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

XLSX 생성, 편집 및 분석

작업접근 방식
수식/서식이 있는 생성 또는 편집openpyxl — 아래 주의사항 참고
대량 데이터 입/출력pandas (read_excel, to_excel)
시트 빠른 미리보기markitdown file.xlsx — 시트당 ## 시트이름; .xlsm도 읽음. 셀 좌표는 제공되지 않으므로 이를 기반으로 편집 계획을 세우지 마세요
모델 읽기 (수식 및 값)두 번의 load_workbook 패스 — 주의사항 참고

openpyxl, pandas, markitdown은 사전 설치되어 있습니다 — pip install을 먼저 실행하지 말고, 바로 스크립트를 작성하고 import 하세요. import가 실패하거나 markitdown 명령어가 없을 경우에만 누락된 패키지를 pip install 하세요.

아래 스크립트 경로는 이 스킬 디렉토리를 기준으로 합니다.

모든 출력에 대한 요구사항

  • 전문적인 폰트 (Arial, Times New Roman)를 전체에 적용하세요. 단, 사용자가 다른 것을 명시하지 않은 경우에 한합니다.
  • 수식 오류 제로. recalc.py가 errors_found를 보고하는 한 절대 배포하지 마세요. 오류가 기존에 존재했다고 생각되면 증명하세요: data_only=True로 원본을 로드하여 해당 셀을 확인하세요. 당신이 도입한 오류는 기존 오류와 똑같이 보입니다.
  • 하드코딩된 결과가 아닌 수식을 사용하세요. Python에서 계산한 합계가 아닌 sheet['B10'] = '=SUM(B2:B9)'를 작성하세요. 시트는 입력값이 변경될 때 재계산되어야 합니다.
  • 사용자의 명세를 문자 그대로 따르세요. 정확한 탭 이름, 정확한 열 헤더, 사용자가 지정한 수식을 그대로 사용하세요. 다른 것을 계산하는 재설계는 아무리 우아해도 실패입니다.
  • 모든 가정과 하드코딩된 숫자를 문서화하세요. 독자가 볼 수 있는 위치(셀 주석 또는 표 끝의 인접 셀)에 기록하세요. 실제 출처가 있으면 이를 인용하세요(출처: 회사 10-K, FY2024, 45쪽, 수익 주석, [SEC EDGAR URL]); 숫자가 사용자로부터 온 것이라면 그대로 명시하세요.
  • 사용자가 채울 목적으로 당신이 생성한 통합 문서에는 편집할 셀을 명시하는 짧은 범례와 예상 형식을 보여주는 한 행의 실제 예시 값이 필요합니다. 편집 요청을 받은 파일에는 이러한 행을 추가하지 마세요.
  • 기존 파일 편집: 그 파일의 규칙을 정확히 따르세요. 그 규칙이 여기의 모든 지침보다 우선합니다. 먼저 지정된 입력 셀(구별되는 폰트 색상, 채우기, 또는 음영으로 표시됨)을 찾아 그곳에만 작성하고, 기존 수식은 그대로 두세요.

재계산 (파일에 수식이 포함된 경우 필수)

openpyxl은 수식을 문자열로 작성하며 캐시된 값이 없습니다. 재계산할 때까지 모든 수식 셀은 캐시된 값을 읽는 모든 것(pandas, load_workbook(data_only=True), 대부분의 미리보기 도구)에 대해 None으로 읽힙니다.

python scripts/recalc.py output.xlsx [시간제한_초]   # 기본값 30

LibreOffice가 모든 수식을 계산하고, 파일은 제자리에서 덮어쓰기되며, JSON이 반환됩니다: status (success | errors_found), total_formulas, total_errors, 그리고 오류 유형별 최대 100개 셀을 명명한 error_summary (locations_truncated는 얼마나 많은 항목이 생략되었는지 알려줍니다 — 목록 길이가 아닌 total_errors를 신뢰하세요). 명명된 셀을 수정하고 다시 실행하세요. status 대신 error 키가 있는 JSON은 재계산되지 않았음을 의미하며, 이 경우에만 종료 코드가 0이 아닙니다 — errors_found는 종료 코드 0을 반환하므로, 깨끗한 종료를 깨끗한 통합 문서로 간주하지 마세요.

재계산 성공은 수식이 평가된다는 것을 증명할 뿐, 올바르다는 것을 증명하지 않습니다. 범위가 하나 벗어나거나 잘못된 행을 참조하면 오류 없는 깨끗한 파일이지만 잘못된 숫자가 생성됩니다. 먼저 2~3개의 수식을 작성하여 예상 값을 가져오는지 확인한 후, 전체 그리드를 구축하세요.

다른 파일에 연결된 통합 문서는 openpyxl로 다시 저장한 후 재계산하면 해당 연결이 손실됩니다. 이러한 수식은 ='[1]수익률 분석'!$B$2로 읽힙니다 — [1]은 통합 문서의 외부 참조 목록 인덱스로, 시트가 아닌 디스크의 별도 파일을 가리킵니다. 그 파일이 여기에 있는 경우는 드물기 때문에, 셀의 캐시된 값이 데이터를 유지하는 유일한 수단입니다. openpyxl은 저장 시 그 값을 제거하고, LibreOffice는 실제로 참조를 해석해야 하므로 실패하여 #NAME?을 쓰고 모든 링크를 삭제합니다. recalc.py는 이 상태에서 실행을 거부합니다 — 덮어쓰기 전에 원본에서 해당 셀의 값을 복사하세요 (--force는 재정의하며 손실을 감수합니다).

검증을 통과하는 수식 선택

LibreOffice는 Excel보다 적은 함수를 구현하며, 평가할 수 없는 함수는 #NAME?이 되어 제공하는 파일에 그대로 박힙니다.

  • Excel 2007 시대 함수를 선호하세요 — SUMIFS, INDEX, MATCH, IFERROR, SUMPRODUCT — 접두사가 필요 없습니다.
  • 6개의 2007 이후 함수는 _xlfn. 접두사가 필요합니다. openpyxl이 수식을 XML에 그대로 쓰고 Excel이 2007 이후 이름을 접두사로 저장하기 때문입니다(UI에서는 접두사가 숨겨짐): _xlfn.TEXTJOIN, _xlfn.CONCAT, _xlfn.IFS, _xlfn.SWITCH, _xlfn.MAXIFS, _xlfn.MINIFS. 접두사 없이 쓰면 각각 #NAME?이 됩니다.
  • XLOOKUP, XMATCH, SORT, FILTER, UNIQUE, SEQUENCE는 절대 사용하지 마세요. 런타임의 LibreOffice는 어떤 접두사로도 이를 평가할 수 없습니다. 최신 빌드에서는 평가하지만, 이는 분산 배열 함수이며 openpyxl로 작성된 파일에는 분산 메타데이터가 없으므로 범위의 왼쪽 위 셀만 값을 얻고 — recalc.py는 잘린 결과에 대해 total_errors: 0을 보고합니다. 조회에는 INDEX/MATCH를 사용하고, 정렬, 필터링, 중복 제거는 셀을 작성하기 전에 Python에서 수행하세요.
  • LibreOffice가 구문 분석할 수 없는 수식은 소문자로 다시 작성됩니다 — #NAME? 옆에서 빠르게 식별할 수 있습니다.

openpyxl 주의사항

  • 모델을 읽으려면 두 번 로드해야 합니다. data_only=True는 수식이 사라진 캐시된 값을 제공하고, 기본값은 값이 없는 수식 문자열을 제공합니다. 한 번의 패스로 둘 다 얻을 수 없습니다.
  • data_only=True는 저장 시 파괴적입니다. 해당 통합 문서에는 수식이 남아 있지 않으므로 저장하면 모든 수식이 리터럴로 영구적으로 대체됩니다.
  • openpyxl이 방금 쓴 파일을 data_only=True로 읽으면 모든 곳에서 None을 반환합니다 — 먼저 recalc.py를 실행하세요. (결과가 ""인 수식도 None으로 읽힙니다.)
  • 병합된 셀: 왼쪽 위 앵커에만 쓰세요. 범위의 다른 모든 셀은 읽기 전용인 MergedCell입니다.
  • .xlsm은 keep_vba=True를 load_workbook에 전달하지 않으면 매크로가 손실됩니다.
  • 공백이 포함된 시트 이름은 시트 간 참조에서 따옴표로 묶어야 합니다: ='가정 입력'!$B$5. 따옴표가 없으면 #VALUE!로 평가됩니다.

금융 모델

사용자가 달리 명시하지 않거나 기존 파일이 다른 작업을 수행하지 않는 경우에 적용합니다.

색상: 하드코딩된 입력 및 시나리오 레버는 파란색 텍스트 (0,0,255) · 수식은 검정 · 다른 시트에 대한 링크는 녹색 (0,128,0) · 다른 파일에 대한 링크는 빨간색 (255,0,0) · 주요 가정 및 사용자가 채워야 할 셀은 노란색 채우기 (255,255,0).

숫자: 통화 $#,##0, 헤더에 단위 명시 (수익 ($mm)) · 0은 -로 표시됨, 백분율 포함 ($#,##0;($#,##0);-) · 음수는 괄호 안에 · 백분율 0.0%, 분수로 저장 (0.15는 15.0%로 표시됨; 15를 저장하면 1500.0%로 표시됨) · 가치 평가 배수 0.0x · 연도는 텍스트로 ("2024", 절대 2,024 아님).

구조: 모든 가정은 자체 레이블이 지정된 셀에, 이를 사용하는 수식에서 참조 (=B5*(1+$B$6), 절대 =B5*1.05 아님) · 모든 예측 기간에 걸쳐 수식 일관성 유지, 행 중간에 단독으로 편집된 셀이 가장 흔한 무음 오류이기 때문 · 0이 될 수 있는 분모를 보호.

종속성

openpyxl, pandas, markitdown (pip, 사전 설치 — import 실패 또는 명령어 누락 시에만 설치) · LibreOffice (soffice, scripts/office/soffice.py를 통해 샌드박스 환경에 맞게 자동 구성됨)

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Reference for the Claude API / Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration. TRIGGER — read BEFORE opening the target file; don't skip because it "looks like a one-liner" — whenever: the prompt names Claude/Anthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing/model choice/limits/caching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent/MCP/tool-definition/multi-agent/RAG/LLM-judge/computer-use; generate/summarize/extract/classify/rewrite/converse over NL; debugging refusals/cutoffs/streaming/tool-calls/tokens). SKIP only when another provider is being worked on (overrides all triggers): OpenAI/GPT/Gemini/Llama/Mistral/Cohere/Ollama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIR...

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

관련 스킬