site-architecture

site-architecture skill 개요

site-architecture가 해결하도록 설계된 일

site-architecture skill은 AI assistant가 기술 SEO, 크롤링 가능성, 내비게이션, URL 정리, 내부 링크 관점에서 웹사이트 구조를 진단하거나 재설계하고, 새 구조를 계획하도록 돕습니다. 특히 문제가 구조적인 경우에 가장 유용합니다. 예를 들어 URL 폴더 체계가 뒤죽박죽이거나, 허브 페이지가 약하거나, 고아 페이지가 많거나, 내비게이션이 불명확하거나, 크롤링 경로가 좋지 않거나, SEO 리스크를 줄이면서 정보 구조를 설계해야 하는 사이트 이전 프로젝트에 잘 맞습니다.

가장 잘 맞는 사용자와 프로젝트

이 site-architecture skill은 포괄적인 마케팅 조언보다 실행 가능한 사이트 구조 권장안을 원하는 SEO 컨설턴트, 기술 SEO 팀, 콘텐츠 리드, 창업자, 개발자에게 적합합니다. 특히 SaaS, B2B, 콘텐츠 사이트, 문서 사이트, e-commerce 카테고리 구조, 로컬 서비스 사이트, 토픽 클러스터나 hub-and-spoke 모델 중심으로 재정비하는 사이트에 유용합니다.

일반 프롬프트보다 강한 점

일반 프롬프트도 “내부 링크를 개선하라”고 말할 수는 있지만, 이 skill은 assistant가 따라야 할 명확한 워크플로를 제공합니다. 현재 상태, 목표, 제약 조건을 수집하고, URL 패턴을 평가하며, 내비게이션 깊이를 매핑하고, 내부 링크 모델을 추천하는 방식입니다. 또한 repository에는 references/internal-linking-playbook.md, references/url-design-guide.md, scripts/sitemap_analyzer.py가 포함되어 있어 짧은 SEO 체크리스트보다 훨씬 실무적으로 사용할 수 있습니다.

이 skill이 적합하지 않은 경우

새로 발행할 글 주제를 정하거나, 페이지 카피를 작성하거나, schema markup을 구현하거나, 키워드 리서치를 처음부터 수행하는 주된 도구로 site-architecture를 사용하지는 마세요. 페이지가 어디에 위치해야 하는지, 서로 어떻게 연결되어야 하는지를 명확히 해 이런 작업을 보조할 수는 있지만, 핵심 가치는 콘텐츠 아이디어나 structured data가 아니라 사이트 아키텍처에 있습니다.

site-architecture skill 사용 방법

site-architecture 설치와 repository 경로

GitHub skill repository에서 다음 명령으로 설치합니다.

npx skills add alirezarezvani/claude-skills --skill site-architecture

소스는 alirezarezvani/claude-skills의 marketing-skill/skills/site-architecture에 있습니다. 설치 후에는 먼저 SKILL.md를 읽고, 이어서 다음 파일을 확인하세요.

• references/internal-linking-playbook.md
• references/url-design-guide.md
• scripts/sitemap_analyzer.py

이 skill 폴더에는 별도의 README나 metadata 파일이 없으므로, 주요 운영 지침은 SKILL.md와 두 개의 reference guide에 들어 있습니다.

site-architecture 활용도를 높이는 입력값

site-architecture를 제대로 활용하려면 “SEO 구조를 고쳐줘”보다 더 구체적인 정보를 제공해야 합니다. 이 skill은 다음 정보가 있을 때 가장 잘 작동합니다.

• Website URL 및 CMS 또는 framework
• sitemap.xml URL 또는 내보낸 sitemap
• 섹션별 대략적인 페이지 수
• 주요 비즈니스 모델: lead gen, SaaS, e-commerce, media, local, documentation
• 알려진 문제: orphan pages, duplicate pages, thin category pages, crawl bloat, poor rankings
• 순위를 올리거나 보호하고 싶은 priority pages
• 제약 조건: URL 변경 불가, migration deadline, CMS limits, engineering capacity

더 좋은 프롬프트 예시는 다음과 같습니다.

Use the site-architecture skill to audit our B2B SaaS site. Sitemap: https://example.com/sitemap.xml. We have feature pages, solution pages, integrations, docs, and 250 blog posts. Our priority is ranking solution pages without changing existing high-performing blog URLs. Identify structural issues, recommend URL folder rules, navigation changes, hub pages, and internal links. Flag anything that needs redirects or developer work.

아키텍처 진단을 위한 권장 워크플로

먼저 근거부터 확보하세요. sitemap이 있다면 scripts/sitemap_analyzer.py를 실행하거나 assistant에게 사용하도록 요청해 URL depth, section distribution, duplicate path patterns, possible orphan candidates를 살펴보게 합니다. 그런 다음 결과를 url-design-guide.md와 비교해 일관성 없는 slug, 지나치게 깊은 folder, date-based blog paths, trailing slash 규칙 혼재, 불명확한 section naming을 찾아냅니다.

다음으로 internal-linking-playbook.md를 사용해 링크 패턴을 선택합니다. 토픽 권위를 쌓는 데는 보통 hub-and-spoke가 더 적합하고, course나 documentation에는 linear linking이 잘 맞으며, e-commerce에는 category-to-product 모델이 적합합니다. 리소스가 제한되어 있다면 전체 재설계보다 우선순위가 정리된 수정 목록을 요청하세요.

실무에 쓰기 좋은 프롬프트 패턴

완성도 높은 site-architecture guide 프롬프트에는 원하는 출력 형식이 포함되어야 합니다. 예를 들면 다음과 같습니다.

Produce: 1) current architecture diagnosis, 2) URL rule recommendations, 3) proposed navigation model, 4) internal linking plan by page type, 5) redirect/migration risks, 6) 30-day implementation plan, 7) open questions.

이렇게 하면 막연한 조언을 줄이고, assistant가 SEO, 콘텐츠, 엔지니어링 팀에 바로 전달할 수 있는 의사결정 중심 결과를 내도록 유도할 수 있습니다.

site-architecture skill FAQ

site-architecture는 Technical Seo 작업에 적합한가요?

네. site-architecture for Technical Seo는 crawl paths, indexable URL patterns, site depth, internal linking, breadcrumbs, duplicate structural patterns, migration-safe URL decisions가 포함된 작업에 잘 맞습니다. 다만 log-file analysis, Core Web Vitals debugging, schema implementation에는 상대적으로 덜 적합하며, 해당 이슈가 아키텍처와 직접 연결되어 있을 때만 보조적으로 활용하는 편이 좋습니다.

초보자도 이 skill을 사용할 수 있나요?

네. 다만 초보자는 구체적인 사이트 정보를 제공하고 설명을 함께 요청하는 것이 좋습니다. 이 skill에는 실무적인 reference가 포함되어 있으므로 “각 권장사항을 설명하고, 그것이 crawlability나 rankings에 왜 중요한지 알려줘”라고 요청할 수 있습니다. 처음 사용할 때는 전체 재설계를 바로 요청하기보다 먼저 진단을 요청하는 것이 좋습니다.

일반 SEO 프롬프트와 어떻게 다른가요?

일반 SEO 프롬프트는 “내부 링크를 추가하라”거나 “URL을 더 짧게 만들라”처럼 넓은 권장사항에 그치는 경우가 많습니다. 이 skill은 현재 상태, 목표, 제약 조건, URL design, navigation, linking architecture를 분리해 더 구조적으로 다룹니다. 포함된 sitemap analyzer 덕분에 원시 sitemap 데이터에서 실행 가능한 발견 사항으로 이어지는 경로도 더 명확합니다.

언제 설치하지 않는 편이 좋나요?

블로그 주제 아이디어, metadata rewrite, product descriptions, schema snippets만 필요하다면 site-architecture를 설치하지 않는 편이 좋습니다. 또한 고위험 migration의 유일한 판단 근거로 사용해서도 안 됩니다. 이 skill로 architecture plan을 만든 뒤, redirects, canonicals, analytics, crawl data는 사용하는 SEO 도구로 반드시 검증하세요.

site-architecture skill 개선 방법

skill에 실제 사이트 근거를 제공하세요

site-architecture 출력 품질을 높이는 가장 좋은 방법은 sitemap, 현재 navigation, 핵심 page types, ranking priorities를 제공하는 것입니다. domain을 공유할 수 없다면 섹션별로 익명화한 URL 예시를 제공하세요. 실제 예시가 있어야 assistant가 문제가 depth인지, naming인지, duplication인지, weak hubs인지, missing links인지 더 정확히 판단할 수 있습니다.

관찰이 아니라 결정을 요청하세요

약한 요청은 “우리 구조를 어떻게 생각해?”라고 묻는 것입니다. 더 좋은 요청은 다음과 같습니다.

Recommend the preferred URL structure for features, integrations, solutions, blog, and docs. Keep existing ranking blog URLs unchanged unless there is a clear SEO reason to migrate. Mark each recommendation as keep, change, merge, redirect, or investigate.

이렇게 요청하면 skill이 구현 가능한 수준의 아키텍처 가이드를 만들도록 강제할 수 있습니다.

흔한 실패 패턴을 주의하세요

흔한 실패 패턴에는 migration risk 없이 URL 변경을 추천하는 것, hub page를 과도하게 많이 만드는 것, 의미와 상관없이 모든 URL을 무조건 평평하게 만드는 것, 문맥상 도움이 되지 않는 내부 링크를 제안하는 것이 있습니다. assistant에게 “safe quick wins”와 “migration-level changes”를 구분하게 하고, 각 구조 권장사항의 SEO tradeoff를 설명하도록 요청하세요.

첫 출력 이후 반복해서 다듬으세요

첫 번째 답변은 최종 계획이 아니라 architecture map 초안으로 다루세요. 이후 crawl data, Search Console exports, analytics priorities, CMS restrictions, developer feedback을 추가로 제공하세요. 그런 다음 site-architecture skill에 계획을 단계별 roadmap으로 다시 정리해 달라고 요청하세요. 예를 들어 즉시 적용할 internal links, navigation cleanup, URL governance rules, 장기적인 restructuring으로 나눌 수 있습니다.