Habilidades docusaurus-deployer
📚
docusaurus-deployer
Seguro ⚙️
Comandos externos🌐
Acceso a red🔑
Variables de entorno📁
Acceso al sistema de archivos
Docusaurus를 GitHub Pages에 배포
También disponible en: 92Bilal26
Docusaurus 문서를 GitHub Pages에 배포하려면 빌드 설정, GitHub Actions 워크플로, 배포 브랜치를 구성해야 합니다. 이 스킬은 사전 검증된 템플릿과 CI/CD 트리거 전에 수행되는 로컬 테스트를 통해 전체 과정을 자동화합니다.
Soporta: Claude Codex Code(CC)
1
Descargar el ZIP de la skill
2
Subir en Claude
Ve a Configuración → Capacidades → Skills → Subir skill
3
Activa y empieza a usar
Pruébalo
Usando "docusaurus-deployer". Deploy my Docusaurus documentation to GitHub Pages for the first time
Resultado esperado:
- Docusaurus 사이트를 GitHub Pages에 배포하도록 도와드리겠습니다.
- 1단계: 프로젝트 분석
- docusaurus.config.ts, sidebars.ts, package.json을 확인하기 위해 Docusaurus 구조를 살펴보겠습니다.
- 2단계: 구성 검증
- GitHub Pages 호환성 설정(url, baseUrl, organizationName, projectName)을 확인합니다.
- 3단계: 로컬 테스트
- 푸시 전에 npm ci, npm run typecheck, npm run build, npm run serve를 실행해 검증합니다.
- 4단계: CI/CD 설정
- 공식 GitHub Actions Pages 배포를 사용해 .github/workflows/deploy.yml을 생성합니다.
- 5단계: 리포지토리 구성
- GitHub Actions에서 배포를 활성화하도록 GitHub Pages 설정을 안내합니다.
- Docusaurus 프로젝트 위치와 GitHub 리포지토리 URL은 무엇인가요?
Usando "docusaurus-deployer". Create a GitHub Actions workflow for my Docusaurus site
Resultado esperado:
- 자동화된 Docusaurus 배포를 위한 GitHub Actions 워크플로를 만들겠습니다.
- 워크플로는 다음을 수행합니다:
- - main 브랜치에 푸시될 때 트리거
- - npm 캐시를 사용한 Node.js v20
- - 의존성 깨끗한 설치를 위해 npm ci 실행
- - TypeScript 검증을 위해 npm run typecheck 실행
- - npm run build로 사이트 빌드
- - actions/deploy-pages@v4로 배포
- 리포지토리에서 필요한 설정:
- 1. .github/workflows/deploy.yml 생성
- 2. 리포지토리 설정에서 GitHub Pages 활성화
- 3. 배포 소스를 GitHub Actions로 설정
- 지금 deploy.yml 파일을 만들어 드릴까요?
Auditoría de seguridad
Segurov3 • 1/16/2026
Documentation-only skill providing Docusaurus deployment guides and templates. All 385 static findings are false positives - they flag example commands and configuration in markdown documentation, not executable code. No actual network calls, credential access, or code execution occurs. Prior audit confirmed safe rating.
8
Archivos escaneados
1,956
Líneas analizadas
4
hallazgos
3
Auditorías totales
Factores de riesgo
⚙️ Comandos externos (294)
references/configuration-guide.md:5 references/configuration-guide.md:9 references/configuration-guide.md:11-27 references/configuration-guide.md:27-33 references/configuration-guide.md:33 references/configuration-guide.md:33-35 references/configuration-guide.md:35-44 references/configuration-guide.md:44-47 references/configuration-guide.md:47 references/configuration-guide.md:47-48 references/configuration-guide.md:48-49 references/configuration-guide.md:49 references/configuration-guide.md:49 references/configuration-guide.md:49-53 references/configuration-guide.md:53 references/configuration-guide.md:53 references/configuration-guide.md:53-55 references/configuration-guide.md:55-64 references/configuration-guide.md:64-67 references/configuration-guide.md:67 references/configuration-guide.md:67-68 references/configuration-guide.md:68-69 references/configuration-guide.md:69-75 references/configuration-guide.md:75 references/configuration-guide.md:75-76 references/configuration-guide.md:76 references/configuration-guide.md:76-77 references/configuration-guide.md:77-78 references/configuration-guide.md:78 references/configuration-guide.md:78-83 references/configuration-guide.md:83 references/configuration-guide.md:83 references/configuration-guide.md:83 references/configuration-guide.md:83 references/configuration-guide.md:83 references/configuration-guide.md:83-84 references/configuration-guide.md:84 references/configuration-guide.md:84 references/configuration-guide.md:84 references/configuration-guide.md:84 references/configuration-guide.md:84 references/configuration-guide.md:84-87 references/configuration-guide.md:87-88 references/configuration-guide.md:88 references/configuration-guide.md:88-89 references/configuration-guide.md:89-92 references/configuration-guide.md:92-93 references/configuration-guide.md:93-103 references/configuration-guide.md:103 references/configuration-guide.md:103-104 references/configuration-guide.md:104 references/configuration-guide.md:104-112 references/configuration-guide.md:112-114 references/configuration-guide.md:114-130 references/configuration-guide.md:130-133 references/configuration-guide.md:133-139 references/configuration-guide.md:139-141 references/configuration-guide.md:141-146 references/configuration-guide.md:146-148 references/configuration-guide.md:148-166 references/configuration-guide.md:166-172 references/configuration-guide.md:172-173 references/configuration-guide.md:173 references/configuration-guide.md:173-174 references/configuration-guide.md:174 references/configuration-guide.md:174-175 references/configuration-guide.md:175-176 references/configuration-guide.md:176-177 references/configuration-guide.md:177-178 references/github-actions-guide.md:9 references/github-actions-guide.md:9 references/github-actions-guide.md:21 references/github-actions-guide.md:22 references/github-actions-guide.md:25 references/github-actions-guide.md:29 references/github-actions-guide.md:30 references/github-actions-guide.md:33 references/github-actions-guide.md:39 references/github-actions-guide.md:40 references/github-actions-guide.md:41 references/github-actions-guide.md:50-79 references/github-actions-guide.md:79-88 references/github-actions-guide.md:88-91 references/github-actions-guide.md:91-104 references/github-actions-guide.md:104-116 references/github-actions-guide.md:116-118 references/github-actions-guide.md:118-121 references/github-actions-guide.md:121-125 references/github-actions-guide.md:125-127 references/github-actions-guide.md:127-140 references/github-actions-guide.md:140-144 references/github-actions-guide.md:144-148 references/github-actions-guide.md:148-157 references/github-actions-guide.md:157-189 references/github-actions-guide.md:189-198 references/github-actions-guide.md:198-204 references/github-actions-guide.md:204-210 references/github-actions-guide.md:210-217 references/github-actions-guide.md:217-218 references/github-actions-guide.md:218-225 references/github-actions-guide.md:225-235 references/github-actions-guide.md:235-250 references/github-actions-guide.md:250 references/github-actions-guide.md:250-251 references/github-actions-guide.md:251 references/github-actions-guide.md:251-257 references/github-actions-guide.md:257-282 references/github-actions-guide.md:282-289 references/github-actions-guide.md:289-318 references/github-actions-guide.md:318-335 references/github-actions-guide.md:335-336 references/github-actions-guide.md:336-337 references/github-actions-guide.md:337-340 references/github-actions-guide.md:340-343 references/local-validation-guide.md:11-14 references/local-validation-guide.md:14-16 references/local-validation-guide.md:16-22 references/local-validation-guide.md:22-24 references/local-validation-guide.md:24-39 references/local-validation-guide.md:39-41 references/local-validation-guide.md:41-44 references/local-validation-guide.md:44-49 references/local-validation-guide.md:49-53 references/local-validation-guide.md:53-66 references/local-validation-guide.md:66-68 references/local-validation-guide.md:68-70 references/local-validation-guide.md:70-139 references/local-validation-guide.md:139-140 references/local-validation-guide.md:140-141 references/local-validation-guide.md:141-152 references/local-validation-guide.md:152-153 references/local-validation-guide.md:153-163 references/local-validation-guide.md:163-172 references/local-validation-guide.md:172-174 references/local-validation-guide.md:174-180 references/local-validation-guide.md:180-183 references/local-validation-guide.md:183 references/local-validation-guide.md:183-184 references/local-validation-guide.md:184-185 references/local-validation-guide.md:185-186 references/local-validation-guide.md:186-191 references/local-validation-guide.md:191-194 references/local-validation-guide.md:194 references/local-validation-guide.md:194-195 references/local-validation-guide.md:195-196 references/local-validation-guide.md:196-197 references/local-validation-guide.md:197 references/local-validation-guide.md:197-208 references/local-validation-guide.md:208-215 references/local-validation-guide.md:215-228 references/local-validation-guide.md:228-229 references/local-validation-guide.md:229-230 references/local-validation-guide.md:230-231 references/performance-standards.md:14 references/performance-standards.md:15 references/performance-standards.md:16 references/performance-standards.md:31 references/performance-standards.md:32 references/performance-standards.md:41 references/performance-standards.md:42 references/performance-standards.md:114-126 references/performance-standards.md:126-129 references/performance-standards.md:129-136 references/performance-standards.md:136-139 references/performance-standards.md:139-141 references/performance-standards.md:141-147 references/performance-standards.md:147-151 references/performance-standards.md:151-159 references/performance-standards.md:159-165 references/performance-standards.md:165-172 references/performance-standards.md:172-187 references/performance-standards.md:187-197 references/performance-standards.md:197-213 references/performance-standards.md:213 references/performance-standards.md:213-215 references/performance-standards.md:215 references/performance-standards.md:215-217 references/performance-standards.md:217 references/performance-standards.md:217-220 references/performance-standards.md:220-231 references/performance-standards.md:231-240 references/performance-standards.md:240-249 references/performance-standards.md:249-252 references/performance-standards.md:252-254 references/performance-standards.md:254 references/performance-standards.md:258 references/performance-standards.md:258-261 references/performance-standards.md:261 references/performance-standards.md:268 references/performance-standards.md:268-269 references/performance-standards.md:269-274 references/performance-standards.md:274-280 references/performance-standards.md:280-281 references/performance-standards.md:281-282 references/performance-standards.md:282-286 references/performance-standards.md:286 references/performance-standards.md:286-295 references/performance-standards.md:295-300 references/performance-standards.md:300-320 references/performance-standards.md:320-340 references/troubleshooting.md:6 references/troubleshooting.md:9 references/troubleshooting.md:9 references/troubleshooting.md:10 references/troubleshooting.md:11 references/troubleshooting.md:12 references/troubleshooting.md:27 references/troubleshooting.md:37 references/troubleshooting.md:38-46 references/troubleshooting.md:46-57 references/troubleshooting.md:57 references/troubleshooting.md:57-58 references/troubleshooting.md:58 references/troubleshooting.md:58-60 references/troubleshooting.md:60-66 references/troubleshooting.md:66-70 references/troubleshooting.md:70-76 references/troubleshooting.md:76-87 references/troubleshooting.md:87-90 references/troubleshooting.md:90-93 references/troubleshooting.md:93-105 references/troubleshooting.md:105-115 references/troubleshooting.md:115-126 references/troubleshooting.md:126-129 references/troubleshooting.md:129-138 references/troubleshooting.md:138-174 references/troubleshooting.md:174-177 references/troubleshooting.md:177-187 references/troubleshooting.md:187-198 references/troubleshooting.md:198-202 references/troubleshooting.md:202-205 references/troubleshooting.md:205-207 references/troubleshooting.md:207-210 references/troubleshooting.md:210-216 references/troubleshooting.md:216-219 references/troubleshooting.md:219-223 references/troubleshooting.md:223-230 references/troubleshooting.md:230-234 references/troubleshooting.md:234-236 references/troubleshooting.md:236-239 references/troubleshooting.md:239-241 references/troubleshooting.md:241-244 references/troubleshooting.md:244-246 references/troubleshooting.md:246-249 references/troubleshooting.md:249-253 references/troubleshooting.md:253-263 references/troubleshooting.md:263-264 references/troubleshooting.md:264-269 references/troubleshooting.md:269-285 references/troubleshooting.md:285-288 references/troubleshooting.md:288-290 references/troubleshooting.md:290-293 references/troubleshooting.md:293-295 references/troubleshooting.md:295-298 references/troubleshooting.md:298-301 references/troubleshooting.md:301-331 references/troubleshooting.md:331 references/troubleshooting.md:331 references/troubleshooting.md:331 references/troubleshooting.md:331-337 references/troubleshooting.md:337-343 references/troubleshooting.md:343-353 references/troubleshooting.md:353 references/troubleshooting.md:353-355 references/troubleshooting.md:355-357 references/troubleshooting.md:357-360 references/troubleshooting.md:360-374 references/troubleshooting.md:374-377 references/troubleshooting.md:377-380 references/troubleshooting.md:380-384 references/troubleshooting.md:384-387 references/troubleshooting.md:387-391 references/troubleshooting.md:391-394 SKILL.md:43-47 SKILL.md:47-51 SKILL.md:51-54 SKILL.md:54 SKILL.md:54-60 SKILL.md:60-65 SKILL.md:65-67 SKILL.md:67-71 SKILL.md:71-75 SKILL.md:75-80 SKILL.md:80 SKILL.md:80-82 SKILL.md:82-86 SKILL.md:86-95 SKILL.md:95-103 SKILL.md:103-104 SKILL.md:104-105 SKILL.md:105-106 SKILL.md:106-107 SKILL.md:107-108 SKILL.md:108-128
🌐 Acceso a red (33)
references/configuration-guide.md:18 references/configuration-guide.md:18 references/configuration-guide.md:37 references/configuration-guide.md:57 references/configuration-guide.md:83 references/configuration-guide.md:84 references/configuration-guide.md:103 references/configuration-guide.md:104 references/configuration-guide.md:135 references/configuration-guide.md:155 references/github-actions-guide.md:189 references/github-actions-guide.md:250 references/github-actions-guide.md:251 references/github-actions-guide.md:347 references/github-actions-guide.md:348 references/github-actions-guide.md:349 references/github-actions-guide.md:350 references/github-actions-guide.md:351 references/local-validation-guide.md:70 references/local-validation-guide.md:153 references/local-validation-guide.md:234 references/local-validation-guide.md:235 references/local-validation-guide.md:236 references/performance-standards.md:32 references/performance-standards.md:247 references/performance-standards.md:248 references/troubleshooting.md:57 references/troubleshooting.md:58 references/troubleshooting.md:101 references/troubleshooting.md:404 references/troubleshooting.md:405 references/troubleshooting.md:406 skill-report.json:6
🔑 Variables de entorno (3)
Auditado por: claude Ver historial de auditorías →
Puntuación de calidad
45
Arquitectura
90
Mantenibilidad
87
Contenido
22
Comunidad
100
Seguridad
100
Cumplimiento de la especificación
Lo que puedes crear
첫 문서 설정
새 Docusaurus 사이트를 적절한 CI/CD 자동화와 함께 GitHub Pages에 구성하고 배포합니다.
CI/CD 파이프라인 생성
푸시할 때마다 문서를 빌드하고 배포하는 자동화된 GitHub Actions 워크플로를 설정합니다.
배포 문제 해결
배포된 문서에서 빌드 실패, 404 오류, 깨진 링크 같은 일반적인 문제를 진단하고 해결합니다.
Prueba estos prompts
기본 배포
Deploy my Docusaurus site to GitHub Pages. My repository is at github.com/username/repo-name and the Docusaurus files are in the docs/ directory.
CI/CD 설정
Create a GitHub Actions workflow for deploying my Docusaurus documentation. I want it to build automatically when I push to main branch.
구성 확인
Check if my Docusaurus configuration is correct for GitHub Pages deployment. My docusaurus.config.ts is at docs/docusaurus.config.ts.
배포 문제 수정
My Docusaurus site shows 404 errors after deployment. The site builds successfully locally but not on GitHub Pages. Help me troubleshoot.
Mejores prácticas
- 오류를 조기에 잡기 위해 변경 사항을 푸시하기 전에 항상 로컬 검증(typecheck, build, serve)을 실행하세요
- GitHub Pages에서 올바른 탐색을 보장하려면 하드코딩된 URL 대신 문서 내 상대 링크를 사용하세요
- 변경 사항을 병합하기 전에 CI/CD가 성공적으로 실행되도록 브랜치 보호 규칙을 구성하세요
Evitar
- 로컬 테스트 없이 배포하면 CI/CD 실행 실패와 문서 손상으로 이어집니다
- markdown 파일에서 상대 경로 대신 하드코딩된 URL을 사용하면 탐색이 깨집니다
- npm run typecheck 단계를 건너뛰면 CI/CD에서 TypeScript 오류로 인해 빌드가 실패합니다
Preguntas frecuentes
이 스킬은 어떤 Node.js 버전을 지원하나요?
이 스킬은 Docusaurus 요구 사항에 맞춰 Node.js v20 이상을 지원합니다. 워크플로는 기본적으로 Node 20을 사용합니다.
사용자 페이지와 프로젝트 페이지의 차이는 무엇인가요?
사용자 페이지는 main 브랜치 루트에서 배포됩니다. 프로젝트 페이지는 gh-pages 브랜치에서 배포되며 baseUrl에 리포지토리 이름을 포함해야 합니다.
기존 CI/CD에 이 스킬을 어떻게 통합하나요?
.github/workflows 디렉터리에 deploy.yml 워크플로를 추가하세요. main 브랜치에 푸시될 때 트리거되며 Pages 배포를 위한 공식 GitHub Actions를 사용합니다.
배포 중 제 데이터는 안전한가요?
네. 이 스킬은 구성 파일을 읽고 배포 워크플로를 생성할 뿐입니다. 표준 GitHub API 호출 외에 외부 서비스로 데이터가 전송되지 않습니다.
성공적으로 배포했는데 사이트가 404를 표시하는 이유는 무엇인가요?
일반적인 원인은 잘못된 baseUrl 설정, 프로젝트 페이지에서의 누락된 트레일링 슬래시, 또는 잘못된 브랜치/소스를 가리키는 GitHub Pages 설정입니다.
다른 배포 방법과 비교하면 어떤가요?
이 스킬은 권장 방식인 GitHub Actions를 사용합니다. 대안으로는 gh-pages 브랜치에 수동 배포하거나 서드파티 CI 서비스를 사용하는 방법이 있습니다.