SuperAPI AI Directory
Partner中文AI newsFavorites
Skillsreading-guide

reading-guide

Office & productivity

View repository

Updated 10-15 19:48

About this skill

Reading Guide Skill

Analyze the paper PDF and generate a "pre-reading navigation." Since the purpose is for the user to grow by reading the paper themselves, do not summarize the content on their behalf; instead, guide the structure and terminology in advance to improve reading efficiency.

Workflow

[입력: 논문 PDF 또는 Zotero library.json에서 새 논문 감지]
      ↓
[1] 논문 전문 읽기 (PDF 텍스트 추출)
      ↓
[2] 읽기 가이드 생성
    ├── Zotero 태그 추천
    ├── 핵심 질문 요약 (2~3문장)
    ├── 논문 구조 미리보기 테이블
    ├── 용어 사전
    ├── (양적연구일 경우) 연구 모형 다이어그램
    └── 워크시트 (능동적 읽기용 질문)
      ↓
[3] Guides 폴더에 저장
      ↓
[4] 품질 체크리스트 검증

Phase 1: Reading the Paper

Extract the text from the PDF using pymupdf or similar and read the full text. Things to identify at this stage:

  1. Paper type: review paper, quantitative study, qualitative study, meta-analysis, theoretical paper, etc.
  2. Section structure: title, page range, and role of each section
  3. Key variables: independent variables, mediators, dependent variables (for quantitative studies)
  4. Technical terms: list of terms that are difficult to understand without prior knowledge
  5. Key tables/figures: numbers of the tables or figures that form the heart of the paper

Phase 2: Zotero Tag Recommendations

Based on the paper content, recommend 3–7 tags to attach in Zotero.

Tag selection rules:

  • Use Korean consistently (the language the user would naturally think of when searching)
  • For proper nouns/theory names, add a tag with the original-language term alongside it when needed (e.g., 좌절-공격 가설 + frustration-aggression)
  • For quantitative studies, include the independent variables, mediators, and dependent variables each as tags
  • Include a study type tag (e.g., 양적연구, 리뷰논문, 질적연구, 메타분석)
  • Include a field tag (e.g., 사회심리학, 상담, 발달심리, 가족복지)

Tag table format:

Tag Reason
{태그명} {one-line explanation of why this tag is applied}

Wrap tag names in backticks so the user can copy and paste them directly in Zotero.

Phase 3: Reading Guide Body

3.1 "What is this paper trying to do?"

Explain the background and context in 2–3 sentences. At a level where even someone unfamiliar with this field can feel, "Ah, so that kind of problem exists." Use everyday language instead of academic terms.

Below that, add a one-line summary: the paper's core claim in one sentence in everyday language.

3.2 Paper Structure Preview

Page Section Role Reading tip
p.XX {section name} {what this section does} {pace control + focus point}

Rules for writing reading tips:

  • Pace guidance: "skim lightly," "read slowly," "read with focus"
  • Focus points: "focus on the definition," "just check Table 3," "read only the conclusion paragraph"
  • Highlight the 1–2 most important sections with a ⭐ mark
  • When the paper is long: guide sections that can be skipped ("you can come back to this part later when needed")

3.3 Terms You Need to Know in Advance

Term 뜻 In simple terms
{English term} ({Korean}) {Academic definition} {Everyday analogy or simple explanation}

Selection Criteria: Include only terms that are difficult to understand without prior knowledge. Also include basic terms that anyone majoring in the field would naturally know (since the user has weaknesses in structuring). For the "In simple terms" column, use analogies, everyday situations, or one-line comparisons.

3.4 Research Model Diagram (for quantitative research)

If there is a research model such as structural equation modeling, regression analysis, or a mediation/moderation model, visualize the relationships between variables as an ASCII diagram. Leave it blank so the user can fill it in while reading which arrows are significant and which are not.

3.5 Worksheet

Create questions in a fill-in-the-blank format to be completed while reading the paper. Since it is structured as answering set questions rather than free-form notes, it prevents concentration from wandering.

Worksheet Question Writing Rules:

  • Each question points to a specific section/page of the paper (clearly indicating where to find the answer)
  • Focus on questions asking "Why?" and "How?" rather than simple fact-checking
  • For quantitative research, include structured questions such as "Mark with O/X which paths are significant"
  • The number of questions is proportional to the paper's length: short papers (10p)은 Q1Q5, long papers (20p+) Q1~Q8
  • The last two questions are always fixed:
    • "My thoughts": The part that was most interesting or raised questions while reading
    • "Parts I don't understand": Parts that are not understood or need further explanation
  • If you don't know, ?guide them to leave it as

Phase 4: Save

Filename Rules: {대표저자}_{연도}_읽기가이드.md

  • Korean paper example: 장혜림_2013_읽기가이드.md
  • English paper example: Berkowitz_1989_읽기가이드.md

Save Location: Obsidian vault의 Guides/ folder

  • The vault path follows the user's workspace folder
  • If the Guides folder does not exist, create it automatically

Phase 5: Worksheet Review (when the user returns)

When the user returns after filling out the worksheet:

  1. Confirm the parts that are correct
  2. ?Explain the parts left as
  3. Point out missed points
  4. Discuss the user's "My thoughts"
  5. If necessary, call the survey-paper skill to generate the final survey note

Reading Guide Template

# 읽기 가이드: {대표 저자} ({연도})

> 이 가이드를 먼저 읽고 논문에 들어가세요. 5분이면 충분합니다.

---

## Zotero 태그

아래 태그를 Zotero에서 이 논문에 붙여주세요 (논문 우클릭 → 태그 추가):

| 태그 | 이유 |
|------|------|
| `{태그1}` | {이유} |
| `{태그2}` | {이유} |
| ... | ... |

---

## 이 논문이 뭘 하려는 건가?

{2~3문장으로 배경과 맥락. 일상 언어 사용.}

**한 줄 요약**: {핵심 주장을 한 문장으로}

---

## 논문 구조 미리보기

| 페이지 | 섹션 | 역할 | 읽기 팁 |
|--------|------|------|---------|
| ... | ... | ... | ... |

---

## 미리 알아야 할 용어

| 용어 | 뜻 | 쉽게 말하면 |
|------|-----|------------|
| ... | ... | ... |

---

{양적연구일 경우}
## 연구 모형 한눈에 보기

{ASCII 다이어그램}

읽으면서 "어떤 화살표가 유의하고 어떤 건 아닌지"를 채워보세요.

---

## 워크시트: 읽으면서 채우기

논문을 읽으면서 아래 질문에 답을 적어주세요. 한두 줄이면 충분하고, 모르겠으면 **?** 로 남겨두세요.

### Q1. {질문 주제} ({페이지/섹션 범위})
{구체적 질문}

> 답:

{... Q2~Q6}

### Q{N-1}. 내 생각
읽으면서 가장 흥미롭거나 의문이 든 부분은?

> 답:

### Q{N}. 모르겠는 부분
이해가 안 되거나 더 설명이 필요한 부분은?

> 답:

Quality Checklist

Self-verification after generation (all must be ✅ to be complete):

  • Are there 3~7 Zotero tags, are they in Korean, and are the reasons specified?
  • Is "What is this paper trying to do?" understandable without technical terms?
  • Does the paper structure preview include all major sections?
  • Is the most important section highlighted with a ⭐ mark?
  • Is the "in plain words" column of the glossary actually easy?
  • Do the worksheet questions point to specific pages/sections of the paper?
  • Are the last two questions of the worksheet ("My thoughts", "Parts I don't understand") included?
  • Is the entire guide a volume that can be read within 5 minutes?
  • Has it been saved in the Guides folder with the correct filename?

⚠️ If the checklist is not met: Re-verify after fixing the relevant part