hugobowne/show-us-your-agent-skills

프로젝트: heredotnow/skill, here.now 서비스의 공개 에이전트 스킬.

라이선스: MIT, 상위 README.md에 명시된 대로. 상위 저장소에는 별도의 LICENSE 파일이 없으므로 여기에 포함되지 않습니다.

스냅샷: 2026-05-22 기준 heredotnow/skill/here-now의 고정 복사본. 유지 관리되는 버전은 상위 저장소에 있으며 이 스냅샷 이후로 변경되었을 수 있습니다.

here.now

스킬 버전: 1.15.5

here.now는 에이전트가 웹사이트를 게시하고 클라우드 Drives에 비공개 파일을 저장할 수 있게 해줍니다.

here.now는 두 가지 작업을 수행합니다:

• Sites: {slug}.here.now에 웹사이트와 파일을 게시합니다.
• Drives: 에이전트의 비공개 파일을 클라우드 폴더에 저장합니다.

설치 또는 업데이트(권장): npx skills add heredotnow/skill --skill here-now -g

저장소 고정/프로젝트 로컬 설치의 경우 -g 없이 동일한 명령어를 실행합니다.

최신 문서

here.now의 기능, 특징 또는 워크플로우에 대한 질문에 답변하기 전에 최신 문서를 읽으십시오:

→ https://here.now/docs

다음의 경우 문서를 읽으십시오:

• 대화에서 here.now 관련 첫 상호작용 시
• 사용자가 특정 작업 방법을 물을 때마다
• 사용자가 가능한 기능, 지원되는 기능 또는 권장 사항을 물을 때마다
• 사용자에게 기능이 지원되지 않는다고 말하기 전

최신 문서가 필요한 주제(로컬 스킬 텍스트만으로 판단하지 마십시오):

• Drives 및 Drive 공유
• 사용자 정의 도메인
• 공개 프로필
• 프록시 경로 및 서비스 변수
• 서브도메인 핸들 및 링크
• 제한 및 할당량
• SPA 라우팅
• 소유자 Site 검색
• 오류 처리 및 수정
• 기능 가용성

문서와 라이브 API 동작이 일치하지 않으면 라이브 API 동작을 신뢰하십시오.

문서 가져오기가 실패하거나 시간 초과되면 로컬 스킬과 라이브 API/스크립트 출력을 계속 사용하십시오. 활성 작업의 경우 라이브 API 동작을 선호하십시오.

요구 사항

• 필수 바이너리: curl, file, jq
• 선택적 환경 변수: $HERENOW_API_KEY
• 선택적 Drive 토큰 변수: $HERENOW_DRIVE_TOKEN
• 선택적 자격 증명 파일: ~/.herenow/credentials
• 번들 도우미:
  • ./scripts/publish.sh: 사이트 게시용
  • ./scripts/drive.sh: 비공개 Drive 저장소용

사이트 생성하기

./scripts/publish.sh {파일-또는-디렉토리}

라이브 URL(예: https://bright-canvas-a7k2.here.now/)을 출력합니다.

내부적으로는 생성/업데이트 -> 파일 업로드 -> 마무리의 3단계 흐름입니다. 마무리가 성공할 때까지 사이트는 라이브 상태가 아닙니다.

API 키 없이 실행하면 익명 사이트가 생성되어 24시간 후에 만료됩니다. 저장된 API 키가 있으면 사이트는 영구적입니다.

파일 구조: HTML 사이트의 경우 index.html을 게시하려는 디렉토리의 루트에 배치하고 하위 디렉토리 안에 두지 마십시오. 디렉토리의 내용이 사이트 루트가 됩니다. 예를 들어 my-site/index.html이 있는 my-site/ 디렉토리를 게시하십시오. my-site/를 포함하는 상위 폴더를 게시하지 마십시오.

HTML 없이 원시 파일만 게시할 수도 있습니다. 단일 파일은 풍부한 자동 뷰어(이미지, PDF, 비디오, 오디오)를 제공합니다. 여러 파일은 폴더 탐색 및 이미지 갤러리가 포함된 자동 생성 디렉토리 목록을 제공합니다.

기존 사이트 업데이트하기

./scripts/publish.sh {파일-또는-디렉토리} --slug {슬러그}

익명 사이트를 업데이트할 때 스크립트는 .herenow/state.json에서 claimToken을 자동으로 로드합니다. --claim-token {토큰}을 전달하여 재정의합니다.

인증된 업데이트는 저장된 API 키가 필요합니다.

로그인한 사용자는 공개 프로필도 가지고 있습니다. 에이전트는 사용자가 프로필에 Sites를 표시하거나 숨기고 https://here.now/docs#profile에 문서화된 API를 통해 프로필 설정을 관리하도록 도울 수 있습니다.

Drive 사용하기

사용자가 문서, 컨텍스트, 메모리, 계획, 자산, 미디어, 연구, 코드 등 웹사이트로 게시되지 않고 유지되어야 하는 모든 항목에 대해 비공개 클라우드 저장소를 원할 때 Drive를 사용하십시오.

로그인한 모든 계정에는 My Drive라는 기본 Drive가 있습니다.

./scripts/drive.sh default
./scripts/drive.sh ls My Drive
./scripts/drive.sh put My Drive notes/today.md --from ./notes/today.md
./scripts/drive.sh cat My Drive notes/today.md
./scripts/drive.sh share My Drive --perms write --prefix notes/ --ttl 7d

에이전트 간 핸드오프를 위해 범위가 지정된 Drive 토큰을 사용하십시오. herenow_drive 공유 블록을 받으면 해당 token을 api_base에 대한 Authorization: Bearer <token>으로 사용하고, pathPrefix가 있으면 이를 준수하며, 쓰기 시 ETag를 보존하십시오. pathPrefix가 null이면 전체 Drive 액세스를 의미합니다. 스킬을 사용할 수 있으면 ./scripts/drive.sh를 선호하고, 그렇지 않으면 나열된 API 작업을 직접 호출하십시오.

클라이언트 귀속

here.now가 에이전트별 안정성을 추적할 수 있도록 --client를 전달하십시오:

./scripts/publish.sh {파일-또는-디렉토리} --client cursor

이렇게 하면 게시 API 호출 시 X-HereNow-Client: cursor/publish-sh가 전송됩니다. 생략하면 스크립트는 폴백 값을 전송합니다.

API 키 저장

게시 스크립트는 다음 소스에서 API 키를 읽습니다(첫 번째 일치 항목 우선):

1. --api-key {키} 플래그(CI/스크립팅 전용 — 대화형 사용에서는 피하십시오)
2. $HERENOW_API_KEY 환경 변수
3. ~/.herenow/credentials 파일(에이전트에게 권장)

키를 저장하려면 자격 증명 파일에 작성하십시오:

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

중요: API 키를 받은 후 즉시 저장하십시오 — 위 명령어를 직접 실행하십시오. 사용자에게 수동으로 실행하도록 요청하지 마십시오. 대화형 세션에서 --api-key와 같은 CLI 플래그를 통해 키를 전달하지 마십시오. 자격 증명 파일이 선호되는 저장 방법입니다.

자격 증명이나 로컬 상태 파일(~/.herenow/credentials, .herenow/state.json)을 소스 제어에 커밋하지 마십시오.

API 키 얻기

익명(24시간) 사이트에서 영구 사이트로 업그레이드하려면:

1. 사용자에게 이메일 주소를 요청하십시오.
2. 일회용 로그인 코드를 요청하십시오:

curl -sS https://here.now/api/auth/agent/request-code \
  -H "content-type: application/json" \
  -d '{"email": "[email protected]"}'

3. 사용자에게 알리십시오: "here.now에서 보낸 로그인 코드가 포함된 이메일을 확인하고 여기에 붙여넣어 주세요."
4. 코드를 확인하고 API 키를 받으십시오:

curl -sS https://here.now/api/auth/agent/verify-code \
  -H "content-type: application/json" \
  -d '{"email":"[email protected]","code":"ABCD-2345"}'

5. 반환된 apiKey를 직접 저장하십시오(사용자에게 요청하지 마십시오):

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

상태 파일

모든 사이트 생성/업데이트 후 스크립트는 작업 디렉토리의 .herenow/state.json에 작성합니다:

{
  "publishes": {
    "bright-canvas-a7k2": {
      "siteUrl": "https://bright-canvas-a7k2.here.now/",
      "claimToken": "abc123",
      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
      "expiresAt": "2026-02-18T01:00:00.000Z"
    }
  }
}

사이트를 생성하거나 업데이트하기 전에 이 파일을 확인하여 이전 슬러그를 찾을 수 있습니다. .herenow/state.json을 내부 캐시로만 취급하십시오. 이 로컬 파일 경로를 URL로 제시하거나 인증 모드, 만료 또는 클레임 URL의 진실 공급원으로 사용하지 마십시오.

사용자에게 알릴 내용

게시된 사이트의 경우:

• 항상 현재 스크립트 실행의 siteUrl을 공유하십시오.
• 스크립트 stderr의 publish_result.* 줄을 읽고 인증 모드를 확인하십시오.
• publish_result.auth_mode=authenticated인 경우: 사이트가 영구적이며 사용자 계정에 저장되었음을 알리십시오. 클레임 URL이 필요하지 않습니다.
• publish_result.auth_mode=anonymous인 경우: 사이트가 24시간 후에 만료됨을 알리십시오. 클레임 URL(publish_result.claim_url이 비어 있지 않고 https://로 시작하는 경우)을 공유하여 영구적으로 유지할 수 있도록 하십시오. 클레임 토큰은 한 번만 반환되며 복구할 수 없음을 경고하십시오.
• 클레임 URL이나 인증 상태를 확인하기 위해 사용자에게 .herenow/state.json을 검사하라고 절대 말하지 마십시오.

Drives의 경우:

• Drive 파일을 공개 URL로 설명하지 마십시오.
• 범위가 지정된 토큰으로 공유되지 않는 한 Drive 내용은 비공개임을 사용자에게 알리십시오.
• 다른 에이전트와 액세스를 공유할 때는 좁은 pathPrefix와 짧은 TTL이 있는 범위 지정 토큰을 선호하십시오.

publish.sh 옵션

플래그	설명
--slug {슬러그}	생성 대신 기존 사이트 업데이트
--claim-token {토큰}	익명 업데이트를 위한 클레임 토큰 재정의
--title {텍스트}	뷰어 제목 (비-HTML 사이트)
--description {텍스트}	뷰어 설명
--ttl {초}	만료 설정 (인증된 경우만)
--client {이름}	귀속을 위한 에이전트 이름 (예: cursor)
--base-url {url}	API 기본 URL (기본값: https://here.now)
--allow-nonherenow-base-url	기본이 아닌 --base-url로 인증 전송 허용
--api-key {키}	API 키 재정의 (자격 증명 파일 선호)
--spa	SPA 라우팅 활성화 (알 수 없는 경로에 대해 index.html 제공)

publish.sh 외

Drive 작업의 경우 ./scripts/drive.sh 또는 Drive API를 사용하십시오. 더 광범위한 계정 및 Site 관리(검색, 프로필, 삭제, 메타데이터, 비밀번호, 도메인, 서브도메인 핸들, 링크, 변수, 프록시 경로, 복제 등)는 최신 문서를 참조하십시오:

→ https://here.now/docs

전체 문서: https://here.now/docs