paper-readability
Skill0 starsChanged 29 days agoMITView on GitHub
내용이 고정된 논문 원고 전체를 처음 읽는 독자 기준으로 쉽고 매력적으로 다듬을 때 사용. "가독성으로 가자", "읽기 쉽게", "발표 점수 올려", "기호 줄여", "숫자를 표로" 같은 요청에 적용. 주장과 숫자는 바꾸지 않는다. 문장 단위의 문체만 고칠 때는 korean-academic-style을 쓴다.
In this repository20 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- english-academic-styleSkill
- fact-checkSkill
- feasibility-gateSkill
- korean-academic-styleSkill
- literature-scoutSkill
- paper-condenseSkill
- paper-framingSkill
- paper-quality-loopSkill
- paper-reviewSkill
- preregister-sealSkill
- problem-grillSkill
- rebuttalSkill
- research-batchSkill
- research-portfolioSkill
- research-scaffoldSkill
- research-sessionSkill
- seminar-slidesSkill
- submission-packageSkill
The file
Files
논문 가독성 다듬기
내용(주장, 숫자, 인용, 조건)을 고정한 뒤 원고를 처음 읽는 독자에게 쉽고 매력적으로 만드는 절차다. 문체는 english-academic-style, korean-academic-style을, 초록과 서론과 결론의 구조는 paper-framing을, 줄이기는 paper-condense를, 사실 대조는 fact-check를 함께 따른다. paper-quality-loop가 기준을 채워 원고를 고정한 뒤, 또는 사용자가 내용을 고정한 뒤 시작한다. paper-framing의 주장 목록(<원고 폴더>/주장목록.md)을 읽고 고정할 주장의 범위로 삼는다. 프로젝트의 고정 결정 기록이 있으면 그것이 이 스킬보다 앞선다.
research-session의 공통 규칙을 따른다. 역할별 모델은 프로젝트 설정을 따른다.
0. 시작 조건과 지킬 것
- 내용 고정 결정이 기록돼 있다. 무엇이 고정인지(주장, 숫자, 인용, 부등호 방향, 헤지 강도, 정리와 증명의 진술, 표의 칸 값)를 적는다. 없으면 먼저 사용자에게 받아 승인기록에 적는다.
- 새 숫자, 새 주장, 새 인용을 넣지 않는다. 숫자는 지워도 되지만 같은 값이 논문 어딘가(본문, 표, 부록)에 남아야 한다. 예외는 파생값(합, 차, 비율로 바로 나오는 값)과 좌표나 서지 표기다.
- 심사 지적에 답하려고 넣은 문장은 지우지 않고 옮기거나 줄인다. 어느 문장이 어느 지적을 닫는지 변경 기록에서 먼저 찾는다.
- 표현 수준의 정확성 수정(산술 표기 오류, 표와 본문 불일치, 규칙과 구현의 구분)은 허용한다. 주장을 바꾸는 수정은 사용자에게 묻는다.
1. 측정하는 잣대
처음에 측정하고, 끝에 다시 측정한다. 목표는 사용자가 정한다. 아래 목표는 기본값이며 프로젝트 설정으로 바꿀 수 있다.
| 잣대 | 측정하는 법 | 기본값(프로젝트 설정으로 바꿀 수 있음) |
| 본문의 서로 다른 수식 기호 | 표, 그림, 부록을 뺀 본문에서 $…$ 안의 기호를 센다 | 15개 이하 |
| 본문 숫자 밀도 | 절마다 100단어당 숫자 개수 | 서론과 결론 2 이하, 평가 3 이하 |
| 정의 전 사용 용어 | 용어마다 첫 등장 줄과 정의 줄을 비교 | 0 |
| 한 대상 한 이름 | 같은 대상의 이름 수 | 1 |
| 라벨 겹침 | 같은 글자나 번호가 다른 뜻으로 쓰이는 수 | 0 |
| 새 독자가 막힌 곳 | 2절의 새 독자 둘, 독자마다 차단 수 | 독자마다 2 이하 |
| 발표 점수 | 2절의 투고처형 심사 | 투고처 척도에서 중간 이상(예: 5점 중 3) |
| 쪽 수와 초록 | 투고 규정 | 규정 안 |
| 사실 대조 | fact-check | 차이 0 |
| 출판 논문 견본과의 거리 | english-academic-style 7절의 표(문장 길이, 수동태, 헤지, 연결어, 괄호, 한정). 프로젝트에 견본 측정 스크립트가 있으면 그것으로 잰다 | 모든 지표가 견본의 10~90 백분위 안 |
| 그림과 표의 밀도 | 본문 1천 단어당 그림과 표의 수 | 그림 0.4~0.9, 표 0.5 이하 |
새 독자 기준은 독자마다 차단만 센다. paper-quality-loop는 막힌 곳 전체를 센다(3곳 이하). 둘 다 기본값이며 프로젝트 설정으로 바꿀 수 있다.
2. 읽는 쪽
만든 쪽이 채점하지 않는다. 매번 새 에이전트를 띄우고 원고 파일 둘(소스, PDF)만 준다. 이전 심사평과 대화를 주지 않는다.
| 역할 | 지시 | 내는 것 |
| 새 독자 ×2 | 서로 다른 배경(분야 밖 대학원생, 현업 엔지니어). 처음부터 끝까지 한 번 읽고 막힌 곳만: 위치, 인용, 이유, 차단 또는 지연. 과학은 평가하지 않고 고칠 문장도 쓰지 않는다. 끝에 "이 논문으로 무엇을 할 수 있게 되나" 세 문장 | 막힌 곳 목록, 차단 수 |
| 심사(투고처형) ×1~3 | 투고처의 PC 구성(시스템, 이론, 업계 등)을 배경으로 주고 그 투고처의 심사 양식(요약, 강점, 약점, 질문, 발표 지적, 점수 항목)으로 쓰게 한다. 발표 절에는 정의 전 용어, 되읽어야 하는 문장, 표와 그림의 읽기 어려움을 인용과 함께 | 양식대로의 심사, 점수 |
| 통독자 ×1 | 3.1절의 층위 통독. 고치지 않은 새 에이전트가 전체 구조, 장, 문단, 문장의 순서로 읽는다. 문장을 고쳐 쓰지 않고 판정만 한다 | 층별 판정표 |
| 사실 대조 | 고정판과 고친 판을 fact-check로 대조. 지운 숫자마다 중복, 파생, 표로 이동 가운데 하나를 적음 | 대조표, 불일치 수 |
역할별 모델은 프로젝트 설정을 따른다. 사실 대조를 누가 하는지는 공통 규칙 3을 따른다.
새 독자의 세 문장이 논문의 주장과 다르면 초록과 서론이 잘못 읽히는 것이다. 가장 먼저 고친다.
3. 고치는 순서
효과가 큰 것부터 고친다.
- 초록과 서론 첫 문단. 전문 용어 없이 문제, 제시, 쓰임을 쓴다(paper-framing). 전제 목록은 한 구절과 포인터로 줄인다. 비교 대상이 없는 비율("6% 더")은 무엇보다 얼마인지 적거나 뺀다. 모집단(어느 판매자, 어느 자료)을 숫자마다 적는다.
- 한 양에 한 숫자. 같은 양이 재생값, 환산값, 닫힌 식으로 여러 숫자를 가지면 대표값 하나를 정하고 나머지는 표 한 곳에만 둔다. 초록, 서론, 결론이 같은 숫자를 세 번 쓰지 않는다(초록은 말로, 서론은 숫자 한둘, 결론은 적용).
- 기호 줄이기. 본문에 남길 기호 목록을 먼저 정한다. 매개변수 창과 증명 기호는 표와 부록으로, 오류 모형 기호는 표로 옮기고, 한두 번 쓰는 일회용 기호는 말로 푼다. 생소한 표기(필트레이션, σ-field, 보상자)는 본문에 두지 않는다.
- 숫자를 표로. 본문이 표의 숫자를 다시 나열하면 본문은 비교 결론만 남긴다. 숫자가 많이 필요한 곳(가정값, 비용, 민감도)은 작은 표를 새로 만든다.
- 이론의 알갱이 맞춤. 보조정리와 정리의 서술 수준을 하나로 맞춘다. 본문은 말로 쓴 진술(전제와 결론)이고 식, 공식 정의, 증명은 부록에 둔다. 설계 규칙을 정리 항목으로 두지 않는다. 코드 읽기로 얻은 값과 수학적 증명을 같은 이름(보조정리)으로 나란히 두지 않는다.
- 정의 전 용어 0. 첫 등장에서 정의하거나 포인터를 둔다. 규칙과 가정 번호는 정의 뒤에만 참조한다.
- 한 대상 한 이름, 라벨 겹침 0. 용어표를 먼저 만들고 전체를 치환한다. 같은 글자가 보조정리, 부록, 그룹, 가정, 표 행에 쓰이면 바꾼다. 로마 숫자는 한 종류에만 쓴다.
- 기제는 그림으로. 돈 흐름(누가 누구에게 무엇을, 언제), 상태 기계(단계와 기한, 가장 긴 경로), 비교 곡선을 그림으로 그린다. 그림 하나가 긴 설명 문단과 기호 여럿을 대신한다. 캡션은 45단어 이하로, 범례와 캡션의 이름은 같게 쓰고, 익명 투고에는 식별자를 넣지 않는다.
- 표 정리. 행은 제시 설계를 맨 위에 두고, 글자는 표 순서대로 붙이고, 열 단위와 계산 근거(재생, 닫힌 식, 환산)를 표시한다. 캡션에는 정의 없이 읽는 법만 쓴다.
- 규칙 목록은 항목으로. 규칙마다 막는 공격을 한 구절로 붙인다.
- 군더더기 삭제(paper-condense). 중복, 과정 이력, 되풀이 한계, 지나친 자백("증명 아님", "확인 못 함"을 같은 뜻으로 두 번), 결론의 숫자 나열을 지운다. 솔직함은 한 곳에 한 번이면 된다.
- 문단 첫 문장 점검. 첫 문장만 이어 읽어 논증이 따라오는지 본다. 표만 가리키는 첫 문장("Table 3 shows the results.")은 결과를 말하는 문장으로 바꾸고 표는 괄호로 부른다. 출판 논문도 절반쯤의 문단만 첫 문장에 주장을 두므로, 모든 문단을 같은 꼴로 맞추지 않는다. 주장의 근거가 같은 문단이나 바로 옆 표와 그림에 있는지도 본다. 괄호가 두 쌍 이상인 문장은 문장 100개당 9개 이하로 줄인다.
- 문체 전체 적용은 고정 직전에 한 번만 한다(english-academic-style, korean-academic-style). 적용 뒤 fact-check로 다시 대조한다.
3.1 층위 통독 (layered read-through)
새 독자는 막힌 곳을 찾고, 통독자는 구성을 판정한다. 원고를 큰 층에서 작은 층으로 네 번 읽고, 층마다 그 층에서만 보이는 문제를 적는다. 읽는 쪽은 원고를 고친 적 없는 새 에이전트다.
| 층 | 읽는 범위 | 묻는 것 |
| 1. 전체 구조 | 제목, 초록, 절 제목, 표와 그림의 캡션 | 절의 순서가 문제, 정의, 결과, 한계의 흐름을 따르는가. 각 절을 한 문장으로 요약할 수 있는가. 요약표가 그 표에 필요한 정의보다 앞에 오지 않는가 |
| 2. 장(절) | 절마다 첫 문단과 끝 문단 | 절이 약속한 것과 실제로 다루는 것이 같은가. 첫 문단이 앞 절과의 관계나 이 절이 답할 물음을 말하는가. 끝 문단이 다음 절로 넘어가는가. 두 절이 같은 일을 하지 않는가. 서론이 약속한 기여마다 이행하는 절이 있는가 |
| 3. 문단 | 문단의 첫 문장만 이어 읽기(역개요) | 첫 문장이 주장인가(권장이지 규칙은 아니다). 한 문단에 요점이 하나인가. 첫 문장의 사슬이 논증을 따라가는가. 주장의 근거가 같은 문단이나 바로 옆 표와 그림에 있는가 |
| 4. 문장 | 문장 전체 | 되읽어야 하는 문장, 한 문장에 두 주장, 정의 전 용어, 겹친 괄호, 말로 풀 수 있는 기호 |
- 층마다 판정표를 낸다. 열은 위치, 판정(유지, 옮김, 나눔, 합침, 고쳐 씀), 이유다.
- 고치는 쪽은 위층부터 고친다. 옮기거나 합칠 문단의 문장을 먼저 다듬지 않는다. 층 1과 층 2의 판정은 3절 1번보다 앞에 처리하고, 층 3은 3절 12번과, 층 4는 3절 6, 7, 13번과 함께 처리한다.
- 잣대로 쓸 수 있는 값은 두 가지다. 한 문장으로 요약되는 절의 비율, 첫 문장의 사슬이 논증을 따라가는 문단의 비율. 목표는 프로젝트 설정으로 정하고, 정하지 않았으면 기록만 한다.
- 고정된 주장과 숫자에 닿는 판정(문장을 옮기면 헤지가 달라지는 경우 등)은 0절을 따른다.
4. 절차
- 1절 잣대로 현재 상태를 측정하고, 2절의 새 독자 둘과 투고처형 심사 하나, 3.1절의 통독자 하나를 돌린다(기준선).
- 심사의 발표 지적과 새 독자의 막힌 곳을 3절 순서로 묶어 할 일 표를 만든다(항목, 담당, 산출, 통과 조건, 어림). 쪽 수를 벌어야 하는 항목(그림이나 표 추가)은 paper-condense의 절삭 후보 표를 먼저 만들고 사용자에게 큰 삭제만 묻는다.
- 원고를 맡은 실행 에이전트 하나가 항목마다 빌드하며 고친다. 쪽 수, 오류, overfull을 항목마다 확인한다.
- 공통 규칙 3에 따라 원고를 고치지 않은 쪽이 fact-check로 대조한다. 고정판과 고친 판의 숫자, 인용, 부등호, 헤지가 같아야 한다. 차이가 있으면 원인(중복, 파생, 표로 이동)을 적고, 원인이 없으면 되돌린다.
- 새 독자 둘과 투고처형 심사 하나를 다시 돌린다. 심사가 찾은 표현 수준 오류(산술 표기, 표와 본문 불일치, 범례와 캡션)는 고정 전에 고친다.
- 고정한다. 해시, 변경 기록(바뀐 곳과 그에 대응하는 독자나 심사 항목, 지운 숫자 목록, 하지 못한 것), 승인기록, 현황을 남긴다.
5. 멈추는 규칙
- 잣대를 모두 채우면 멈춘다.
- 두 바퀴를 돌려도 발표 점수가 오르지 않으면 문장 수준의 문제가 아니다. 남은 지적은 쪽을 벌어야 하는 것(그림, 기호표, 표 분할)이거나 내용(재생 다시 돌리기)이다. 그 목록을 사용자에게 보이고, 쪽을 벌 삭제를 정하게 하거나 멈춘다.
- 마감까지 남은 날이 한 바퀴보다 적으면 새 바퀴를 시작하지 않는다.
6. 보고
틀은 research-session 8절의 마침 보고다. 결과와 확인 줄에 아래 내용을 넣는다. 쉬운 한국어로 짧게 쓴다. 잣대 전후 표(기호 수, 숫자 밀도, 차단 수, 발표 점수, 쪽 수), 한 일과 하지 못한 일(이유: 쪽, 고정 규칙), 지운 숫자와 그 행방, fact-check 결과, 다음 단계를 담는다. 바뀐 파일은 공통 규칙대로 바로 열 수 있게 보인다.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

