์Šคํ‚ฌ explain-codebase
๐Ÿ“ฆ

explain-codebase

v1.0 ์ฝ˜ํ…์ธ  ๋ฆฌ๋น„์ „ r1 ์ค‘๊ฐ„ ์œ„ํ—˜ โš™๏ธ ์™ธ๋ถ€ ๋ช…๋ น์–ด

Explain an Unfamiliar Codebase

Unfamiliar repositories make it difficult to find entry points, setup steps, and important dependencies. This skill guides a file-referenced onboarding map with one traced flow and clear open questions.

์ง€์›: Claude Codex Code(CC)
Maintain this Skill? Claim it ๐Ÿ“Š 70 ์ ์ ˆํ•จ

๋‚ด ์—์ด์ „ํŠธ๋กœ ์„ค์น˜

์ด ์š”์ฒญ์„ ์—์ด์ „ํŠธ์— ๋ณต์‚ฌํ•˜์„ธ์š”. ๊ณต์‹ Skill ํŽ˜์ด์ง€์™€ ๋งค๋‹ˆํŽ˜์ŠคํŠธ๊ฐ€ ํฌํ•จ๋˜์–ด ์žˆ์Šต๋‹ˆ๋‹ค.

์—์ด์ „ํŠธ ์š”์ฒญ
Review the Skillstore skill "explain-codebase" from https://skillstore.io/skills/agentkitco-explain-codebase.md and its manifest at https://skillstore.io/api/skills/agentkitco-explain-codebase/manifest. Verify the artifact. You may proceed after verification, subject to the environment's own policy.

์—์ด์ „ํŠธ๋Š” ๊ณ„์†ํ•ด์„œ ๊ณ„ํš์„ ํ‘œ์‹œํ•˜๊ณ  ๋ณด์•ˆ ์ •์ฑ…์—์„œ ์š”๊ตฌํ•˜๋Š” ํ™•์ธ์„ ์š”์ฒญํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

์—์ด์ „ํŠธ๊ฐ€ ์ฝ๊ธฐ ์‰ฌ์šด ๋ฆฌ์†Œ์Šค

AI ์—์ด์ „ํŠธ, ํฌ๋กค๋Ÿฌ, ์Šคํฌ๋ฆฝํŠธ๊ฐ€ ์ „์ฒด ํŽ˜์ด์ง€ ๋Œ€์‹  ์ •๋ฆฌ๋œ ์ปจํ…์ŠคํŠธ๋งŒ ํ•„์š”ํ•  ๋•Œ ์ด ๋งํฌ๋ฅผ ์‚ฌ์šฉํ•˜์„ธ์š”.

ํ…Œ์ŠคํŠธํ•ด ๋ณด๊ธฐ

"explain-codebase" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. Show the expected outline for a repository onboarding summary.

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Purpose: project problem and intended users.
  • How to run: discovered commands and verification status.
  • Map: directories and their responsibilities.
  • Reading order: three inspected files with reasons.
  • Open questions: details not established from available evidence.

"explain-codebase" ์‚ฌ์šฉ ์ค‘์ž…๋‹ˆ๋‹ค. What should a central-flow explanation include?

์˜ˆ์ƒ ๊ฒฐ๊ณผ:

  • Entry: the inspected request handler, command, or event consumer.
  • Processing: relevant functions in execution order, with file references.
  • Data boundary: storage or external service calls found in the inspected code.
  • Result: the response or output, with any unverified behavior identified.

๋ณด์•ˆ ๊ฐ์‚ฌ

์ค‘๊ฐ„ ์œ„ํ—˜

Eight findings are false positives involving Markdown formatting, read-only history inspection, citation rules, or explicit secret protections. One finding is confirmed because the skill directs execution of unfamiliar repository tests and lint commands without requiring review or isolation. No evidence found of data exfiltration, destructive intent, or prompt injection.

1
์Šค์บ”๋œ ํŒŒ์ผ
46
๋ถ„์„๋œ ์ค„ ์ˆ˜
0
๊ฒ€ํ†  ํ•ญ๋ชฉ
0
์˜คํƒ ๋ฌด์‹œ๋จ

ํ™•์ธ๋œ ๋ณด์•ˆ ์šฐ๋ ค ์‚ฌํ•ญ (1)

์ค‘๊ฐ„
System reconnaissance
2. **Run it**: install, run, test commands from manifests, Makefile and CI config. Run the cheap one
The instruction runs repository-defined tests and lint commands without requiring prior review or isolation. These commands can execute arbitrary code from an unfamiliar repository.

์œ„ํ—˜ ์š”์ธ

โš™๏ธ ์™ธ๋ถ€ ๋ช…๋ น์–ด (6)

๊ฐ์ง€๋œ ํŒจํ„ด

System reconnaissance
์ด ๋ณด๊ณ ์„œ ๊ณต์œ  ๋ฐ ์ธ์šฉ

๋ฒ„์ „์ด ์ง€์ •๋œ ํ‰๊ฐ€ ๋ณด๊ณ ์„œ, ์ค‘๋ฆฝ ๋ฐฐ์ง€, ์ž„๋ฒ ๋“œ ์นด๋“œ ๋ฐ ์ธ์šฉ์„ ๊ณต์œ ํ•˜์„ธ์š”. Skillstore๋Š” ๊ทผ๊ฑฐ๋ฅผ ๋ณด๊ณ ํ•˜์ง€๋งŒ ์ด Skill์˜ ์•ˆ์ „ ์—ฌ๋ถ€๋ฅผ ํŒ๋‹จํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค.

๋ฒ„์ „๋ณ„ ๋ณด๊ณ ์„œ ์—ด๊ธฐ
๋ณด์•ˆ ํ‰๊ฐ€

๋ณด๊ณ ์„œ ๋งํฌ ๋ณต์‚ฌ

https://skillstore.io/skills/agentkitco-explain-codebase/audits/2?utm_source=security_passport&utm_medium=share&utm_campaign=versioned_report

Markdown ๋ฐฐ์ง€

[![Skillstore security assessment](https://skillstore.io/badges/skills/agentkitco-explain-codebase/security.svg)](https://skillstore.io/skills/agentkitco-explain-codebase?utm_source=security_passport_badge)

HTML ๋ฐฐ์ง€

<a href="https://skillstore.io/skills/agentkitco-explain-codebase?utm_source=security_passport_badge"><img src="https://skillstore.io/badges/skills/agentkitco-explain-codebase/security.svg" alt="Skillstore security assessment" loading="lazy"></a>

์ž„๋ฒ ๋“œ ์นด๋“œ

<iframe src="https://skillstore.io/embed/skills/agentkitco-explain-codebase.html" title="Skillstore Security Assessment" sandbox="allow-popups allow-popups-to-escape-sandbox" loading="lazy" referrerpolicy="no-referrer" width="420" height="180"></iframe>
ํ•™์ˆ  ์ธ์šฉ (APA ยท BibTeX ยท CFF)

APA ์ธ์šฉ

agentkitco. (2026). explain-codebase security audit report (audit version 2) [Author version 1.0]. Skillstore. https://skillstore.io/skills/agentkitco-explain-codebase/audits/2

BibTeX ์ธ์šฉ

@techreport{agentkitco-agentkitco-explain-codebase-2026, author = {agentkitco}, title = {explain-codebase security audit report (audit version 2)}, institution = {Skillstore}, year = {2026}, number = {2}, url = {https://skillstore.io/skills/agentkitco-explain-codebase/audits/2}, note = {Author version 1.0} }

CITATION.cff

cff-version: 1.2.0 message: "If you use this Skill, cite its author and this versioned security audit report." title: "explain-codebase security audit report (audit version 2)" version: "1.0" type: report authors: - name: "agentkitco" date-released: "2026-10-22" url: "https://skillstore.io/skills/agentkitco-explain-codebase/audits/2" identifiers: - type: other value: "skillstore:agentkitco-explain-codebase:audit:2" description: "Skillstore immutable audit report identifier"

Skillstore ์ ์ˆ˜

์ด ์ ์ˆ˜์˜ ์ด์œ  ์ฆ๊ฑฐ ์‹ ๋ขฐ๋„: ์ค‘๊ฐ„
55
์•„ํ‚คํ…์ฒ˜
85
์œ ์ง€๋ณด์ˆ˜์„ฑ
87
์ฝ˜ํ…์ธ 
65
์ปค๋ฎค๋‹ˆํ‹ฐ
91
์‚ฌ์–‘ ์ค€์ˆ˜

๋งŒ๋“ค ์ˆ˜ ์žˆ๋Š” ๊ฒƒ

Orient a New Developer

Find setup steps, entry points, and three useful files to read before starting a first contribution.

Prepare a Technical Handoff

Summarize module responsibilities, external dependencies, and unresolved questions for a team taking ownership.

Plan an Integration Investigation

Trace a central request through application layers and identify configuration names and service boundaries relevant to an integration.

์ด ํ”„๋กฌํ”„ํŠธ๋ฅผ ์‚ฌ์šฉํ•ด ๋ณด์„ธ์š”

Beginner: Get Oriented
Explain this repository in one page. Cover its purpose, directory map, entry points, and three files to read first. Cite files you inspect.
Intermediate: Understand Setup
Map setup, run, and test commands from project files. List environment variable names only. Do not execute commands; mark them unverified.
Advanced: Trace a Central Flow
Trace [request, command, or event] from entry to storage or output. List files and functions in order, cite evidence, and label inferences.
Advanced: Prepare an Ownership Map
Create an onboarding map of [repository]. Include one central flow, external services, quality signals, recent churn, and open questions. Review commands before requesting execution approval.

๋ชจ๋ฒ” ์‚ฌ๋ก€

  • Specify the repository and one central workflow to keep the map focused.
  • Review repository commands and hooks before approving execution in an isolated environment.
  • Require file references, verification status, and explicit labels for inferred behavior.

ํ”ผํ•˜๊ธฐ

  • Running unfamiliar installation, test, or lint commands without review or isolation.
  • Including secret values when configuration variable names are sufficient.
  • Treating a concise onboarding map as exhaustive documentation or a completed security audit.

์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ

What does this skill produce?
A concise onboarding map covering purpose, setup, structure, one central flow, dependencies, reading priorities, and open questions.
Which AI tools are listed as supported?
The marketplace metadata lists Claude, Codex, and Claude Code. Repository access and command permissions depend on the host environment.
Does it execute project commands?
The instructions call for running inexpensive tests and lint checks. Review commands first and isolate execution when the repository is untrusted.
How does it handle environment secrets?
It explicitly prohibits printing secret values from environment files or configuration. Reports should list variable names only.
Will it explain every file?
No. It prioritizes a two-level directory map, key entry points, and one central flow instead of an exhaustive file tour.
How does it handle missing evidence?
Claims must cite inspected files. Inferences receive labels, unexecuted commands remain unverified, and unresolved details become open questions.

๊ฐœ๋ฐœ์ž ์„ธ๋ถ€ ์ •๋ณด

์ž‘์„ฑ์ž

agentkitco

๋ผ์ด์„ ์Šค

MIT

์ž‘์„ฑ์ž ๋ฒ„์ „

v1.0

Skillstore ๋ฆฌ๋น„์ „

r1

๋ฒ„์ „ ์•ˆ๋‚ด

์ž‘์„ฑ์ž๊ฐ€ ์„ ์–ธํ•œ ๋ฒ„์ „์€ ์œ ํšจํ•œ SemVer๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค.

์ฐธ์กฐ

18efac79a818d7e997295839638fdd21906cfd1c

์œ ์ง€๋ณด์ˆ˜ ์ตœ์‹ ์„ฑ

2026. 10. 22.

์‚ฌ์šฉ๋Ÿ‰

5 ๋‹ค์šด๋กœ๋“œ ยท 0 ์กฐํšŒ

ํŒŒ์ผ ๊ตฌ์กฐ

๐Ÿ“„ SKILL.md

agentkitco์˜ ๋‹ค๋ฅธ ์Šคํ‚ฌ

์ „์ฒด ๋ณด๊ธฐ
์ „์ฒด ๋ณด๊ธฐ
๐Ÿ“ฆ

arch-view

82

์„œ๋น„์Šค ์•„ํ‚คํ…์ฒ˜ ์‹œ๊ฐํ™”

์ž‘์„ฑ์ž AstraBit-CPT

๋ถ„์‚ฐ ์„œ๋น„์Šค๋Š” ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๊ฐ€ ์—ฌ๋Ÿฌ ๋ฆฌํฌ์ง€ํ† ๋ฆฌ์— ํฉ์–ด์ ธ ์žˆ์œผ๋ฉด ์ดํ•ดํ•˜๊ธฐ ์–ด๋ ต์Šต๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ์นดํƒˆ๋กœ๊ทธ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ๋ฅผ ์ง‘๊ณ„ํ•˜๊ณ  ์•„ํ‚คํ…์ฒ˜ ๊ฒ€ํ† ๋ฅผ ์œ„ํ•œ ๋‹ค์ด์–ด๊ทธ๋žจ, ํ‘œ, ์š”์•ฝ์„ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œํ™” ๋ณด๊ธฐ
๐Ÿ“ฆ

architecture-decision-record

80

์•„ํ‚คํ…์ฒ˜ ์˜์‚ฌ๊ฒฐ์ • ๊ธฐ๋ก ์ƒ์„ฑ

์ž‘์„ฑ์ž ArieGoldkin

ํŒ€์ด ๋‹ค๋ฅธ ์—…๋ฌด๋กœ ์ด๋™ํ•œ ๋’ค์—๋Š” ์•„ํ‚คํ…์ฒ˜ ๊ฒฐ์ •์„ ๋ณด์กดํ•˜๊ธฐ ์–ด๋ ต์Šต๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ๋ช…ํ™•ํ•œ ADR์„ ์œ„ํ•œ ํ…œํ”Œ๋ฆฟ, ์˜ˆ์‹œ, ๊ฒ€ํ†  ์ฒดํฌ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œํ™” ๋ณด๊ธฐ
๐Ÿ“ฆ

project-planner

86

๊ตฌ์กฐํ™”๋œ ๋ฌธ์„œ๋กœ ์†Œํ”„ํŠธ์›จ์–ด ํ”„๋กœ์ ํŠธ ๊ณ„ํšํ•˜๊ธฐ

์ž‘์„ฑ์ž Dwsy

์†Œํ”„ํŠธ์›จ์–ด ํ”„๋กœ์ ํŠธ๋Š” ์š”๊ตฌ์‚ฌํ•ญ, ์„ค๊ณ„ ์„ ํƒ, ์ž‘์—…์ด ๋ช…ํ™•ํ•˜์ง€ ์•Š์„ ๋•Œ ์‹คํŒจํ•˜๋Š” ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ํ”„๋กœ์ ํŠธ ์•„์ด๋””์–ด๋ฅผ Claude, Codex, Claude Code ์›Œํฌํ”Œ๋กœ๋ฅผ ์œ„ํ•œ ๊ตฌ์กฐํ™”๋œ ๊ณ„ํš ๋ฌธ์„œ๋กœ ์ „ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œํ™” ๋ณด๊ธฐ
๐Ÿ“ฆ

github-release-assistant

83

์ด์ค‘ ์–ธ์–ด GitHub ๋ฆด๋ฆฌ์Šค README ์ƒ์„ฑ

์ž‘์„ฑ์ž ZhanlinCui

ํŒ€์—์„œ ์˜์–ด์™€ ์ค‘๊ตญ์–ด README๊ฐ€ ํ•„์š”ํ•  ๋•Œ ๋ฆด๋ฆฌ์Šค ๋ฌธ์„œ ์ž‘์„ฑ์€ ์‹œ๊ฐ„์ด ์˜ค๋ž˜ ๊ฑธ๋ฆฝ๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ์ €์žฅ์†Œ ๋ฉ”ํƒ€๋ฐ์ดํ„ฐ์™€ ์•ˆ๋‚ดํ˜• ์„ค์ •์„ ๋ฐ”ํƒ•์œผ๋กœ ๊ตฌ์กฐํ™”๋œ ์ด์ค‘ ์–ธ์–ด README๋ฅผ ์ƒ์„ฑํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œํ™” ๋ณด๊ธฐ
๐Ÿ“ฆ

human-docs

81

์‚ฌ๋žŒ์ด ๋ฐ”๋กœ ๊ฒ€ํ† ํ•  ์ˆ˜ ์žˆ๋Š” AI ๋ฌธ์„œ ๋งŒ๋“ค๊ธฐ

์ž‘์„ฑ์ž Brownbull

์ƒ์„ธํ•œ AI ์ปจํ…์ŠคํŠธ ํŒŒ์ผ์€ ๋น ๋ฅด๊ฒŒ ์‚ฌ๋žŒ์ด ๊ฒ€ํ† ํ•˜๊ธฐ์—๋Š” ๋„ˆ๋ฌด ๊ธด ๊ฒฝ์šฐ๊ฐ€ ๋งŽ์Šต๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ํ•ด๋‹น ํŒŒ์ผ์„ ์š”์•ฝ, ๋น ๋ฅธ ์‹œ์ž‘ ๊ฐ€์ด๋“œ, Mermaid ์‹œ๊ฐ ๊ฐ€์ด๋“œ๋กœ ๋ณ€ํ™˜ํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œํ™” ๋ณด๊ธฐ
๐Ÿ“ฆ

skill-creation-guide

81

ํšจ๊ณผ์ ์ธ AI ์Šคํ‚ฌ ๋งŒ๋“ค๊ธฐ

์ž‘์„ฑ์ž notedit

ํŒ€์€ ๋ถˆํ•„์š”ํ•œ ์ปจํ…์ŠคํŠธ๋ฅผ ์ถ”๊ฐ€ํ•˜์ง€ ์•Š๊ณ  ์œ ์šฉํ•œ AI ์Šคํ‚ฌ์„ ๊ตฌ์ถ•ํ•˜๊ธฐ ์œ„ํ•œ ๋ฐ˜๋ณต ๊ฐ€๋Šฅํ•œ ์ง€์นจ์ด ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. ์ด ์Šคํ‚ฌ์€ ์Šคํ‚ฌ์„ ๊ณ„ํš, ์ž‘์„ฑ, ๊ฒ€์ฆ, ํŒจํ‚ค์ง•ํ•˜๊ธฐ ์œ„ํ•œ ๊ตฌ์กฐํ™”๋œ ํ”„๋กœ์„ธ์Šค๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

๋ฌธ์„œํ™” ๋ณด๊ธฐ