Token导航 LogoToken导航TokenDH.com
研究检索敏感数据github未标认证来源可访问许可证需确认审计异常

k-skill-setupk 技能设置

Agent Skill

k-skill-setup 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

37,248

周安装

1,617

GitHub Stars

4,318

下载量

13,056
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

2

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:k-skill-setup(k 技能设置)
来源仓库:https://github.com/nomadamas/k-skill
仓库路径:skills/k-skill-setup
安装命令:
npx skills add https://github.com/nomadamas/k-skill --skill k-skill-setup
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill;本站只展示命令,不托管安装包,也不自动执行。

skills.shnpx skills
npx skills add https://github.com/nomadamas/k-skill --skill k-skill-setup

简介

k-skill-setup 用于查找、检索和筛选相关信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要根据关键词快速定位候选结果时使用。

  • 适用于技能设置相关的信息收集和资料整理场景。
  • 通过 npx skills add 命令从指定 GitHub 仓库安装,需确认权限范围和维护状态后再使用。
  • 安装前建议核实是否会触发联网、命令执行或文件读写操作,避免影响系统安全。
  • 具体用法请结合原始 README 文档进一步核验功能细节和使用限制。

SKILL.md

k-skill Setup

Purpose

전체 k-skill 설치가 끝난 뒤, 공통 후속 작업을 처리한다.

  • credential 확보 (에이전트 vault 또는 기본 secrets.env)
  • 런타임 환경변수 확인
  • 선택 사항: 주기적인 업데이트 확인 자동화
  • 선택 사항: GitHub star 여부 확인 및 동의 시 실행

이 스킬의 기본 정책:

  • 시크릿이 없으면 필요한 값 이름을 사용자에게 정확히 알려준다
  • credential resolution order에 따라 확보한다
  • 필요한 패키지가 없으면 대체 구현을 찾기보다 전역 설치를 먼저 시도한다
  • cron, launchd, schtasks, gh 같은 지속성/외부 상태 변경은 자동으로 하지 말고 먼저 사용자 동의를 받는다
  • GitHub star는 사용자가 명시적으로 동의했을 때만 실행한다

Credential resolution order

모든 credential-bearing 스킬은 아래 우선순위를 따른다.

  1. 이미 환경변수에 있으면 그대로 사용한다.
  2. 에이전트가 자체 secret vault(1Password CLI, Bitwarden CLI, macOS Keychain 등)를 사용 중이면 거기서 꺼내 환경변수로 주입해도 된다.
  3. ~/.config/k-skill/secrets.env (기본 fallback) — plain dotenv 파일, 퍼미션 0600.
  4. 아무것도 없으면 유저에게 물어서 2 또는 3에 저장한다.

기본 경로에 저장하는 것은 fallback일 뿐, 강제가 아니다.

Standard file location

  • secrets file (기본 fallback): ~/.config/k-skill/secrets.env

Install

이 스킬은 k-skill 전체 스킬 설치가 끝난 뒤 실행하는 것을 기본으로 한다.

예:

npx --yes skills add <owner/repo> --all -g

설치가 끝나면 이 스킬을 호출해 아래 setup 단계를 이어간다.

Setup steps

1. Create the default secrets file (if no vault is in use)

에이전트가 자체 vault를 쓰지 않는 경우, 기본 fallback 파일을 만든다.

mkdir -p ~/.config/k-skill
cat > ~/.config/k-skill/secrets.env <<'EOF'
KSKILL_SRT_ID=replace-me
KSKILL_SRT_PASSWORD=replace-me
KSKILL_KTX_ID=replace-me
KSKILL_KTX_PASSWORD=replace-me
KSKILL_FORESTTRIP_ID=replace-me
KSKILL_FORESTTRIP_PASSWORD=replace-me
LAW_OC=replace-me
KIPRIS_PLUS_API_KEY=replace-me
AIR_KOREA_OPEN_API_KEY=replace-me
KSKILL_PROXY_BASE_URL=https://your-proxy.example.com
EOF
chmod 0600 ~/.config/k-skill/secrets.env

유저에게 물어서 실제 값을 채운다.

서울 지하철 도착정보와 한국 날씨 조회는 hosted public route rollout 이 끝나기 전까지 KSKILL_PROXY_BASE_URL 을 self-host 또는 배포 확인이 끝난 proxy URL 로 채운다. 미세먼지, 한강 수위, 주유소 가격, 생활쓰레기 배출정보 조회, 학교 급식 식단 조회, 의약품 안전 체크, 식품 안전 체크는 KSKILL_PROXY_BASE_URL 을 비워 두면 기본 hosted path(k-skill-proxy.nomadamas.org)를 그대로 쓴다.

한국 법령 검색은 로컬 korean-law-mcp 경로를 쓸 때만 LAW_OC 를 채운다. remote endpoint는 사용자 LAW_OC 없이 url만 등록하면 되고, 기존 경로 장애 시에는 법망(https://api.beopmang.org)을 fallback으로 안내한다.

한국 부동산 실거래가 조회는 기본 hosted proxy(k-skill-proxy.nomadamas.org)를 경유하므로 사용자 쪽 DATA_GO_KR_API_KEY 가 불필요하다.

한국 주식 정보 조회는 기본 hosted proxy(k-skill-proxy.nomadamas.org)를 경유하므로 사용자 쪽 KRX_API_KEY 가 불필요하다. self-host proxy 운영자만 서버 환경변수 KRX_API_KEY 를 사용한다.

도서관 도서 조회는 기본 hosted proxy(k-skill-proxy.nomadamas.org)를 경유하므로 사용자 쪽 DATA4LIBRARY_AUTH_KEY 가 불필요하다. self-host proxy 운영자만 서버 환경변수 DATA4LIBRARY_AUTH_KEY 를 사용한다.

생활쓰레기 배출정보 조회는 k-skill-proxy/v1/household-waste/info 라우트를 호출하고, serviceKey(DATA_GO_KR_API_KEY)는 proxy 서버에서 주입/관리하므로 사용자 쪽 DATA_GO_KR_API_KEY 가 불필요하다.

학교 급식 식단 조회는 k-skill-proxy/v1/neis/school-search·/v1/neis/school-meal을 호출하고, KEDU_INFO_KEY는 프록시 서버에만 두므로 사용자 쪽에 둘 필요가 없다.

도서관 도서 조회는 k-skill-proxy/v1/data4library/* 라우트를 호출하고, DATA4LIBRARY_AUTH_KEY는 프록시 서버에만 두므로 사용자 쪽에 둘 필요가 없다.

근처 가장 싼 주유소 찾기는 기본 hosted proxy를 경유하므로 사용자 쪽 OPINET_API_KEY 가 불필요하다.

의약품 안전 체크는 k-skill-proxy/v1/mfds/drug-safety/lookup 라우트를 호출하고, DATA_GO_KR_API_KEY 는 프록시 서버에서만 주입/관리하므로 사용자 쪽에 둘 필요가 없다.

식품 안전 체크는 k-skill-proxy/v1/mfds/food-safety/search 라우트를 호출하고, DATA_GO_KR_API_KEY 및 선택적 FOODSAFETYKOREA_API_KEY 는 프록시 서버에서만 주입/관리하므로 사용자 쪽에 둘 필요가 없다.

한국 특허 정보 검색은 KIPRIS Plus Open API 경로를 쓸 때 KIPRIS_PLUS_API_KEY 를 채운다. helper는 이 값을 읽어 실제 요청에서 ServiceKey 쿼리 파라미터로 보낸다. 공공데이터포털에서 복사한 percent-encoded key도 그대로 넣어도 된다.

Missing secret response template

인증 스킬에서 값이 빠졌을 때는 credential resolution order에 따라 확보한다.

필요한 값 예:

  • SRT: KSKILL_SRT_ID, KSKILL_SRT_PASSWORD
  • KTX: KSKILL_KTX_ID, KSKILL_KTX_PASSWORD
  • 자연휴양림 빈 객실 조회: KSKILL_FORESTTRIP_ID, KSKILL_FORESTTRIP_PASSWORD
  • 로컬 한국 법령 검색: LAW_OC + korean-law-mcp
  • 한국 법령 검색 remote endpoint: 사용자 LAW_OC 없이 url만 등록, 장애 시 법망 fallback
  • 한국 부동산 실거래가 조회: 사용자 시크릿 불필요 (기본 hosted proxy 사용)
  • 한국 특허 정보 검색: KIPRIS_PLUS_API_KEY
  • 한국 주식 정보 조회: 사용자 시크릿 불필요 (기본 hosted proxy 사용, 운영자만 KRX_API_KEY)
  • 생활쓰레기 배출정보 조회: 사용자 시크릿 불필요 (serviceKey는 proxy 서버 주입, 호출 시 pageNo=1·numOfRows=100 필수)
  • 학교 급식 식단 조회: 사용자 시크릿 불필요 (KEDU_INFO_KEY는 proxy 서버만)
  • 도서관 도서 조회: 사용자 시크릿 불필요 (DATA4LIBRARY_AUTH_KEY는 proxy 서버만)
  • 의약품 안전 체크: 사용자 시크릿 불필요 (DATA_GO_KR_API_KEY는 proxy 서버만)
  • 식품 안전 체크: 사용자 시크릿 불필요 (DATA_GO_KR_API_KEY와 선택적 FOODSAFETYKOREA_API_KEY는 proxy 서버만)
  • 근처 가장 싼 주유소 찾기: 사용자 시크릿 불필요 (기본 hosted proxy 사용)
  • 서울 지하철: self-host 또는 배포 확인이 끝난 KSKILL_PROXY_BASE_URL
  • 한국 날씨: self-host 또는 배포 확인이 끝난 KSKILL_PROXY_BASE_URL
  • 사용자 위치 미세먼지 조회: KSKILL_PROXY_BASE_URL 또는 AIR_KOREA_OPEN_API_KEY

시크릿이 비어 있다는 이유로 다른 서비스나 비공식 우회 경로를 자동 선택하지 않는다.

2. Verify runtime environment

bash scripts/check-setup.sh

3. Offer scheduled update checks

setup이 끝나면 사용자에게 주기적인 업데이트 확인 자동화를 원하는지 먼저 묻는다. 원하지 않으면 건너뛴다.

기본 정책:

  • 자동 설치가 아니라 업데이트 확인 만 기본으로 제안한다
  • 지속성 있는 시스템 변경(crontab, launchd, schtasks)은 동의 없이 적용하지 않는다
  • 기본 확인 명령은 npx --yes skills check
  • 사용자가 명시적으로 자동 업데이트 를 원할 때만 npx --yes skills update 기반 스케줄을 별도로 제안한다

macOS / Linux 예시:

mkdir -p ~/.config/k-skill/bin ~/.config/k-skill/logs
cat > ~/.config/k-skill/bin/check-skill-updates.sh <<'EOF'
#!/usr/bin/env bash
set -euo pipefail
mkdir -p "$HOME/.config/k-skill/logs"
{
  date '+[%Y-%m-%d %H:%M:%S]'
  npx --yes skills check
  printf '\n'
} >> "$HOME/.config/k-skill/logs/skills-check.log" 2>&1
EOF
chmod +x ~/.config/k-skill/bin/check-skill-updates.sh
(crontab -l 2>/dev/null; echo "0 9 * * * $HOME/.config/k-skill/bin/check-skill-updates.sh") | crontab -

Windows 예시:

New-Item -ItemType Directory -Force "$HOME/.config/k-skill/bin" | Out-Null
New-Item -ItemType Directory -Force "$HOME/.config/k-skill/logs" | Out-Null
@'
npx --yes skills check >> "$HOME/.config/k-skill/logs/skills-check.log" 2>&1
'@ | Set-Content "$HOME/.config/k-skill/bin/check-skill-updates.cmd"
schtasks /Create /SC DAILY /TN "k-skill-update-check" /TR "\"$HOME/.config/k-skill/bin/check-skill-updates.cmd\"" /ST 09:00 /F

설정 후에는 로그 위치를 짧게 알려준다:

  • ~/.config/k-skill/logs/skills-check.log

4. Offer GitHub starring with explicit consent

setup 마지막에는 다음처럼 짧게 묻는다.

k-skill 저장소(NomaDamas/k-skill)에 GitHub star를 눌러드릴까요?
원하시면 `gh` 로 바로 처리하고, 원하지 않으면 건너뜁니다.

규칙:

  • 사용자가 명시적으로 동의하기 전에는 gh repo star 를 실행하지 않는다
  • gh 가 없거나 인증되지 않았으면 설치/로그인 안내만 하고 자동 우회하지 않는다
  • star 대상 저장소는 NomaDamas/k-skill 이다

동의했고 gh auth status 가 정상이면:

gh repo star NomaDamas/k-skill

성공하면 짧게 완료만 알린다.

Completion checklist

  • ~/.config/k-skill/secrets.env exists with permission 0600 (또는 에이전트가 자체 vault로 credential을 관리 중)
  • 필요한 환경변수가 설정되어 있다
  • 사용자가 원한 경우에만 업데이트 확인 자동화 또는 GitHub star가 설정되었다

Notes

  • 기본 흐름은 "전체 스킬 설치 → 이 setup skill 실행 → 개별 기능 사용" 이다
  • 저장소 안에는 secret file을 두지 않는다

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Codex

32.78%
按下载量换算4,280

Claude

31.03%
按下载量换算4,051

Cursor

17.61%
按下载量换算2,299

Gemini CLI

8.82%
按下载量换算1,152

安全审计

Gen Agent Trust Hub

通过

Socket

可疑

Snyk

未通过

权限和风险

敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置,应进入高风险复核队列,默认不自动发布。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。当前只有一个来源,正式发布前建议补源仓库或其他目录站核验。

来源信息

继续浏览同类 Skills