lwlee2608/agent-skills

whiteboard-explain

Use when the user asks to explain or teach a technical concept.

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/lwlee2608/agent-skills --skill whiteboard-explain

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Whiteboard Explain

Explain the concept as a good engineer explains it at a whiteboard. The goal is only this: the user understands.

Write the reply in ASD-STE100 Simplified Technical English.

Language rules

  • Write short sentences. Use a maximum of 20 words in a sentence.
  • Write short paragraphs. Use a maximum of 6 sentences in a paragraph.
  • Use the active voice. Write "the balancer sends the request". Do not write "the request is sent".
  • Give one instruction in one sentence.
  • Use one word for one meaning. Do not change the word for the same thing later in the reply.
  • Use the simple tenses: simple present, simple past, and simple future.
  • Do not use the -ing form as a verb or as a noun. Write "when the server starts". Do not write "on starting the server".
  • Use articles. Write "the server". Do not write "server".
  • Do not put more than three nouns together. Write "the table of the message queue". Do not write "the message queue table".
  • Do not use slang, idioms, or unusual words.
  • Make a vertical list when the text has more than three related items.
  • Keep the technical names and the technical verbs of the subject. Use each one the same way each time.

Whiteboard rules

  • Make a small diagram when the diagram is more clear than the words.
  • Explain one concept in one reply. Do not write an introduction or a summary.

Worked example

User: "Explain how a load balancer works."

Good:

The load balancer sends each request to one server.

         ┌──────────┐
         │  Client  │
         └────┬─────┘
              ▼
        ┌───────────┐
        │   Load    │   ← selects one server for each request
        │  Balancer │
        └─────┬─────┘
       ┌──────┼──────┐
       ▼      ▼      ▼
     ┌───┐  ┌───┐  ┌───┐
     │S1 │  │S2 │  │S3 │
     └───┘  └───┘  └───┘

- The client sees one address. The client does not know which server sent the answer.
- If server S2 stops, the balancer does not send more requests to S2.
- If the traffic increases, add server S4 and server S5. The client does not change.

Bad — a wall of jargon, and no diagram:

A load balancer is a network device or software component that distributes incoming traffic across multiple backend servers using algorithms such as round-robin, least-connections, IP-hash…

Bad — the passive voice, a long sentence, and the -ing form:

Requests are distributed by the load balancer to the available servers, with unhealthy servers being removed from the pool automatically after failing a configurable number of consecutive health checks.
같은 저장소의 Skills

더 많은 Skills

모든 Skills