Communitygithub.com

Gyschuaner/사이트-일부-편집

생성된 정적 웹사이트의 한 페이지 섹션, 컴포넌트, 시각적 세부 사항, 텍스트 블록, 반응형 문제 또는 가벼운 상호작용을 전체 사이트를 재구축하지 않고 조정합니다. 히어로 블록, 카드 레이아웃, 사이드바, 푸터, 버튼, 모바일 메뉴, 간격, 색상, 타이포그래피, 애니메이션 강도 또는 페이지 사본의 작은 부분 변경을 포함합니다.

사이트-일부-편집란 무엇인가요?

이 스킬은 기존 정적 사이트의 특정 부분에 집중된, 범위가 제한된 편집을 수행하도록 설계되었습니다. 전체 사이트를 재생성하거나 테마를 변경하지 않고 사용자가 원하는 한 페이지의 섹션, 컴포넌트, 시각적 디테일 또는 가벼운 상호작용을 조정하는 반복적인 다듬기 과정에 적합합니다. 주로 HTML, CSS, 자바스크립트 파일을 직접 수정하며, 히어로 블록, 카드 레이아웃, 푸터, 버튼, 모바일 메뉴, 간격, 색상, 타이포그래피, 애니메이션 등 다양한 요소를 대상으로 합니다. 이 스킬은 Claude Code, Cursor, Codex 등 정적 사이트를 수정할 수 있는 다양한 AI 에이전트 플랫폼에서 사용할 수 있으며, 작업 전후에 브라우저 도구를 사용하여 대상 영역을 확인하고 변경 사항을 검증하는 워크플로우를 따릅니다. 변경이 필요한 경우 `EDITING.md` 파일을 업데이트하여 향후 에이전트가 일관된 방식으로 사이트를 편집할 수 있도록 안내하며, 공유 네비게이션 또는 다중 페이지에 영향을 미치는 넓은 범위의 변경이 필요할 때는 `review-static-site` 스킬을 제안합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/edit-site-part

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사이트 일부 편집

목표

기존 정적 사이트의 한 부분을 개선하면서 사이트의 나머지 부분은 유지합니다.

이 스킬은 사이트가 이미 존재한 후 반복적인 다듬기를 위한 것입니다. 새로운 생성 패스가 아닌 신중한 로컬 편집처럼 느껴져야 합니다.

계약

입력:

  • 기존 정적 사이트 폴더, 대상 페이지, 스크린샷/로컬 URL, 또는 대상 영역에 대한 자연어 설명.
  • EDITING.md 및 관련 HTML/CSS/JS 파일.
  • 원하는 변경 전/후 텍스트, 스타일, 반응형 동작 또는 작은 상호작용 변경.

출력:

  • 영향을 받는 페이지 섹션, 컴포넌트, 복사 블록, 스타일 규칙 또는 가벼운 상호작용에 대한 집중된 편집.
  • 향후 편집 지침을 변경해야 할 때만 업데이트된 EDITING.md.
  • 변경이 이루어진 위치, 변경된 파일 및 수행된 검증에 대한 간략한 보고서.

경계:

  • 전체 사이트를 재구축하거나, 테마 방향을 변경하거나, 게시물을 가져오거나, 여러 필드를 개인화하거나, 게시하지 마십시오.
  • 관련 없는 페이지/자산을 건드리지 마십시오.
  • 종속성, 빌드 단계 또는 루트 절대 사이트 로컬 경로를 도입하지 마십시오.

성공 게이트:

  • 요청된 로컬 변경 사항이 편집 전에 확인된 동일한 브라우저 영역에서 표시됩니다.
  • 데스크톱/모바일 또는 상호작용 검사가 영향을 받는 표면에 대해 통과합니다.
  • 관련 없는 레이아웃 또는 탐색 변경이 도입되지 않았습니다.

게이트 실패 시:

  • 브라우저 영역을 소스에 다시 매핑하고 가장 작은 수정 편집을 수행합니다.
  • 문제가 공유 네비게이션, 여러 페이지, 자산, 인코딩 또는 게시 준비 상태에 영향을 미칠 때 review-static-site를 실행하거나 제안합니다.

사용 시기

사용자가 다음을 요청할 때 이 스킬을 사용하십시오:

  • 한 섹션, 카드, 블록, 컴포넌트 또는 페이지 영역을 변경합니다.
  • 시각적 세부 사항을 더 작고, 차분하며, 조밀하고, 깔끔하며, 더 장난스럽고, 더 기술적이거나, 덜 산만하게 만듭니다.
  • 모바일 레이아웃 문제, 텍스트 오버플로, 간격 문제 또는 어색한 정렬을 수정합니다.
  • 호버, 테마 전환, 메뉴 동작, 복사 버튼, 필터, 탭 또는 애니메이션과 같은 작은 상호작용을 조정합니다.
  • 특정 가시 텍스트 조각을 다시 작성하거나 단축합니다.
  • 특정 영역에 대한 스크린샷 또는 사용자 의견과 일치시킵니다.

전체 사이트 생성, 테마 검색, 새 참조 사이트의 근접 재현, 대규모 개인 콘텐츠 교체, 기사 마이그레이션, 배포 또는 프레임워크 변환에는 이 스킬을 사용하지 마십시오.

입력

사용자가 제공하는 모든 것을 사용하십시오:

  • 사이트 루트 폴더 및 대상 페이지.
  • 문제의 스크린샷, 브라우저 보기, 로컬 URL 또는 자연어 설명.
  • 변경할 정확한 텍스트, 섹션 이름, 클래스 이름 또는 시각적 영역.
  • EDITING.md (있는 경우).
  • 기존 HTML/CSS/JS 파일.
  • 원하는 변경 전/후 문구 또는 스타일 방향.

대상 영역이 모호한 경우 사이트를 검사하고 가장 작은 합리적인 해석을 하십시오. 여러 그럴듯한 편집이 매우 다른 결과를 생성할 경우에만 짧은 확인을 요청하십시오.

워크플로우

  1. 편집 전에 브라우저를 사용하여 대상 페이지 및 대상 영역을 확인하십시오.
  2. EDITING.md가 있으면 읽은 다음 관련 HTML/CSS/JS를 검사하십시오.
  3. 검색을 사용하여 일치하는 가시 텍스트, ID, 클래스, 데이터 블록 또는 컴포넌트 같은 마크업을 찾으십시오.
  4. 확인된 브라우저 영역을 관련 소스 파일, 선택기, 데이터 블록 또는 이벤트 핸들러에 매핑하십시오.
  5. 요청을 충족하는 가장 작은 일관된 편집을 수행하십시오.
  6. 사용자가 명시적으로 변경을 요청하지 않는 한 기존 디자인 언어를 유지하십시오.
  7. 편집 후 동일한 페이지 및 영역으로 브라우저로 돌아가 변경 사항을 확인하십시오.
  8. 변경된 사항을 보고하고 필요한 후속 검증을 언급하십시오.

범위 제어

편집을 로컬로 유지하십시오.

  • 병렬 복제본을 만드는 대신 기존 섹션, 클래스 또는 데이터 객체를 편집하는 것을 선호하십시오.
  • 섹션 수준 변경으로 충분할 때 전체 페이지를 다시 작성하지 마십시오.
  • 사용자가 사이트 전체 스타일 변경을 원하지 않는 한 공유 CSS 변수를 변경하지 마십시오.
  • 관련 없는 페이지, 자산 또는 콘텐츠를 건드리지 마십시오.
  • 네비게이션, 페이지 맵, 플레이스홀더 전략 및 EDITING.md 규칙을 유지하십시오.
  • 사이트의 경로 전략을 유지하십시오. 로컬 편집 중에 /assets/..., /posts/..., /images/... 또는 /data/...와 같은 루트 절대 사이트 로컬 경로를 도입하지 마십시오.
  • 작은 요청이 더 큰 구조적 문제를 드러내면 광범위한 변경을 하기 전에 트레이드오프를 설명하십시오.

사용자가 여러 페이지에서 광범위한 시각적 변화를 요청하는 경우 이 스킬을 확장하는 대신 더 큰 생성 또는 재설계 스킬을 제안하십시오.

올바른 위치 찾기

계층적 조회를 사용하십시오:

  1. 가시 텍스트 또는 근처 레이블을 검색하십시오.
  2. EDITING.md에서 섹션/페이지 맵을 검색하십시오.
  3. 네비게이션 링크 및 페이지 파일 이름을 검사하십시오.
  4. header, main, section, article, aside 및 footer와 같은 시맨틱 태그를 검사하십시오.
  5. CSS 선택기 및 JavaScript 이벤트 훅을 검사하십시오.
  6. 소스 위치가 명확하지 않은 경우 브라우저 개발자 도구 또는 스크린샷을 사용하십시오.

반복 콘텐츠가 데이터에서 렌더링되는 경우 생성된 것처럼 보이는 마크업만 편집하지 말고 소스 데이터를 편집하십시오.

디자인 보존

편집을 현재 사이트에 맞추십시오.

  • 기존 간격, 타이포그래피, 색상, 테두리, 그림자, 아이콘 및 모션 패턴을 재사용하십시오.
  • 데스크톱과 모바일 모두에서 텍스트를 컨테이너 내에 유지하십시오.
  • 장식 효과가 읽기를 방해하지 않도록 하십시오.
  • 애니메이션을 변경할 때 prefers-reduced-motion을 존중하십시오.
  • 사용자가 달리 요청하지 않는 한 기사/세부 페이지는 스타일이 많이 적용된 홈 페이지보다 차분하게 유지하십시오.
  • 개인 웹사이트나 블로그에 마케팅 스타일의 히어로 또는 관련 없는 장식 섹션을 추가하지 마십시오.

텍스트를 변경할 때 기존 음성과 사용자의 언어를 일치시키십시오.

상호작용 편집

JavaScript 또는 상호작용 변경의 경우:

  • 새 이벤트 리스너를 추가하기 전에 기존 이벤트 리스너와 상태 규칙을 찾으십시오.
  • 사이트가 일반 정적인 경우 바닐라 JavaScript를 유지하십시오.
  • 종속성 또는 빌드 단계를 도입하지 마십시오.
  • JavaScript에서 링크, 검색 결과, 이미지 URL 또는 네비게이션 항목을 생성할 때 영향을 받는 페이지 깊이에서 작동하는 페이지-상대 경로를 사용하십시오.
  • 관련된 경우 클릭, 키보드, 모바일 및 반복 사용 상태를 테스트하십시오.
  • 포커스, 레이블 및 축소된 모션 동작과 같은 접근성 기본 사항을 보존하십시오.

반응형 수정

레이아웃 또는 모바일 문제의 경우:

  • 데스크톱 및 모바일 너비를 모두 확인하십시오.
  • 좁은 화면을 수정하면서 데스크톱 레이아웃을 보존하는 CSS 변경을 선호하십시오.
  • 안정적인 치수, 래핑, 최소/최대 너비, 그리드/플렉스 조정 및 오버플로 제어를 사용하십시오.
  • 레이아웃을 맞추기 위해 모바일에서 중요한 콘텐츠를 숨기지 마십시오.

편집 가이드

변경이 향후 편집이 수행되어야 하는 방식에 영향을 미치는 경우 EDITING.md를 업데이트하십시오.

다음 경우에 업데이트하십시오:

  • 새 섹션, 클래스, 데이터 필드 또는 상호작용 패턴이 도입되었습니다.
  • 콘텐츠 저장소가 새 파일 또는 데이터 객체로 이동합니다.
  • 사용자가 향후 에이전트가 보존해야 할 변경을 요청했습니다.

가이드가 오해의 소지가 있지 않는 한 작은 텍스트 또는 간격 변경에는 EDITING.md를 업데이트하지 마십시오.

검증

전체 사이트가 아닌 영향을 받는 표면을 검증하십시오.

편집 전에 실제 사용 가능한 대화형 브라우저 도구를 사용하여 대상 페이지와 영역을 확인하십시오. "사용 가능"은 현재 턴의 호출 가능한 도구 목록에 노출되어 있음을 의미합니다. Codex에서는 턴으로 라우팅될 때 Browser/인앱 브라우저 플러그인일 수 있습니다. 다른 에이전트에서는 동등한 가시 브라우저, browser-use 도구 또는 devtools 지원 브라우저일 수 있습니다. 편집 후 대화형 브라우저의 동일한 페이지와 영역으로 돌아가 결과를 확인하십시오.

호출 가능한 대화형 브라우저 도구가 없는 경우 변경 전/후 브라우저 확인이 발생했다고 가정하지 마십시오. 편집이 시각적 영역 매핑에 의존하는 경우 사용자에게 브라우저 도구를 활성화하거나 호출하도록 요청하십시오. Codex의 경우 @browser를 명시적으로 언급하는 요청을 보내는 것을 의미할 수 있습니다. 사용자가 경로를 변경하지 않거나 클라이언트에 해당 도구가 없는 경우 Playwright, 스크린샷 또는 소스 검사로 대체하고 제한 사항을 명시하십시오.

대화형 브라우저 도구가 실제로 호출 가능할 때 Playwright, 스크린샷 전용 검증 또는 소스 검사 단독을 기본값으로 사용하지 마십시오. 대화형 브라우저 도구를 호출할 수 없거나, 사용자가 명시적으로 요청하거나, 반복 가능한 스크립트화된 회귀 테스트가 구체적으로 필요한 경우에만 Playwright를 대체 수단으로 사용하십시오.

시각적, 반응형 또는 상호작용 편집의 경우 관련 데스크톱/모바일 뷰포트에서 변경된 영역을 확인하고 변경된 상호작용을 실행하십시오.

편집이 공유 네비게이션, 전역 레이아웃, 여러 페이지, 자산 경로, 소스 인코딩 또는 게시 준비 상태에 영향을 미치는 경우에만 review-static-site를 실행하거나 제안하십시오.

편집이 href, src, CSS url(...), 이미지, 글꼴, 파비콘, 데이터 파일 또는 JavaScript 생성 URL을 건드리는 경우 영향을 받는 페이지가 페이지-상대 경로로 여전히 작동하고 정적 파일을 직접 열 때 CSS, JS 또는 이미지가 손실되지 않는지 확인하십시오.

출력

로컬 편집의 경우 다음만 보고하십시오:

  • 변경이 이루어진 위치.
  • 변경된 파일.
  • 수행된 검증.

실제로 권장되는 경우에만 더 넓은 review-static-site 검증을 언급하십시오. 보고서를 반복하거나 전체 코드베이스를 과도하게 설명하지 마십시오.

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

관련 스킬