사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/makerjackie/jackie-skills-starter --skill cloudflare-dns시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Cloudflare DNS
Quick Start
- Clarify target:
- domain/host (
skills.01mvp.com) - record type (
A/AAAA/CNAME/TXT) - target value
- proxied on/off
- Run an auth precheck before any write action.
- Execute idempotent change (query existing record first, then create/update).
- Verify with DNS lookup + HTTP check + (if needed) Pages domain status.
First-Use Auth Gate (Required)
Before first DNS write, check token:
bash
zsh -lic 'echo ${CLOUDFLARE_API_TOKEN:+SET}'If empty, stop and prompt user to configure token first.
Use this prompt style:
- 我先帮你配置，但需要你先提供 Cloudflare API Token（不是 wrangler OAuth）。
- Token 最少权限：
Zone -> DNS -> EditZone -> Zone -> Read- 如果要查 Pages 域名状态，再加：
Account -> Cloudflare Pages -> Edit - Zone Resources 只选目标域名（最小权限原则）。
- 配置完成后执行：
bash
export CLOUDFLARE_API_TOKEN='YOUR_TOKEN'Optional persistent setup:
bash
echo "export CLOUDFLARE_API_TOKEN='YOUR_TOKEN'" >> ~/.zshrc
source ~/.zshrcStandard Execution Pattern
1) Read current DNS record
bash
python - <<'PY'
import json, os, urllib.request
token = os.environ['CLOUDFLARE_API_TOKEN']
zone_id = '<ZONE_ID>'
name = 'skills.01mvp.com'
url = f'https://api.cloudflare.com/client/v4/zones/{zone_id}/dns_records?name={name}'
req = urllib.request.Request(url, headers={'Authorization': f'Bearer {token}'})
print(json.dumps(json.load(urllib.request.urlopen(req)), ensure_ascii=False, indent=2))
PY2) Create/Update record
- If record not found: create.
- If record exists but value/proxy mismatch: update.
- If already correct: report "no-op".
3) Pages custom domain binding (if required)
- Ensure domain is added to the Pages project.
- If not added, create binding first, then ensure DNS points to
<project>.pages.dev.
4) Verification
bash
dig +short CNAME skills.01mvp.com
dig +short skills.01mvp.com
curl -I https://skills.01mvp.comFor Pages validation, also check domain status via Pages API/wrangler.
Safety Rules
- Always query before write (no blind overwrite).
- Prefer least-privilege token scope.
- Never print full token in output.
- Report exact record changed: name, type, content, proxied, timestamp.
- If API returns auth error, explicitly tell user missing scope instead of retrying blindly.
