Agent skill

Nopal Setup

by fivetaku in fivetaku/gptaku-plugins-codex

Codex용 Google Workspace 설정 가이드 스킬. An agent skill from fivetaku/gptaku-plugins-codex.

MITAuto-check: notesBackend & APIs

Install Nopal Setup

skills CLI
$ npx skills add fivetaku/gptaku-plugins-codex --skill nopal-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fivetaku/gptaku-plugins-codex nopal-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fivetaku/gptaku-plugins-codex.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/nopal-codex/skills/nopal-setup .claude/skills/nopal-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
nopal-setup
GitHub stars
128
Token cost
~1.1k tokens
SKILL.md length
572 words
Files
2 (incl. references)
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Codex용 Google Workspace 설정 가이드 스킬. An agent skill from fivetaku/gptaku-plugins-codex.

  • Works in 5 steps: 설치 → 초기 설정 (gws auth setup) → 로그인 (gws auth login) → …
  • Gws authentication
  • SKILL.md covers Codex Workflow, gws CLI란?, 1. 설치 and 2. 초기 설정 (gws auth setup), plus 3 more sections
  • Calls npm and node

What it does

Nopal Setup is an agent skill from fivetaku/gptaku-plugins-codex. Codex용 Google Workspace 설정 가이드 스킬. gws 설치와 OAuth 인증이 필요할 때 사용됩니다. triggers — "gws 설치", "인증 안내", "OAuth 설정", "install gws", "setup", "gws authentication"

Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/setup-guide.md`).

It sits in Backend & APIs, covering Cloud office suites and OAuth and OpenID Connect. It works with Google Workspace and npm. The repository describes itself as: Codex-native GPTaku plugin marketplace. The licence is MIT.

When your agent uses it

  • Gws authentication
  • Tasks that involve Cloud office suites
  • Tasks that involve OAuth and OpenID Connect

Example prompts

  • “gws 설치”
  • “OAuth 설정”
  • “install gws”
  • “/nopal-setup”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 설치
  2. 초기 설정 (gws auth setup)
  3. 로그인 (gws auth login)
  4. 인증 문제 해결
  5. 설치 완료 후

What it can do on your machine

Read from SKILL.md and the folder at commit d3b47fc. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npm
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • console.cloud.google.com
    • cloud.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Nopal Setup loads about 1.1k tokens when it runs, and up to ~1.9k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 572 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~1.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:47
    | permission 에러 | `sudo npm install -g @googleworkspace/cli` 또는 nvm 사용 |

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from fivetaku/gptaku-plugins-codex at commit d3b47fc, republished under its MIT licence (© fivetaku). 572 words, ~1,059 tokens.

Download SKILL.mdSave it as .claude/skills/nopal-setup/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
nopal-setup
description
Codex용 Google Workspace 설정 가이드 스킬. `gws` 설치와 OAuth 인증이 필요할 때 사용됩니다. triggers — "gws 설치", "인증 안내", "OAuth 설정", "install gws", "setup", "gws authentication"

nopal-setup for Codex

Read these first:

  • $PLUGIN_ROOT/skills/nopal-setup/references/setup-guide.md

Use this skill only when gws is missing or authentication is not complete.

Codex Workflow

  1. Explain the missing requirement briefly.
  2. Show the exact setup step the user must perform.
  3. If the step is interactive (TUI), do not pretend Codex can complete it automatically — tell the user to run it in their terminal.
  4. Tell the user what to rerun after setup is finished.

gws CLI란?

gws(Google Workspace CLI)는 Google Workspace 9개 서비스를 터미널에서 조작할 수 있는 공식 CLI 도구다. Nopal은 이 gws CLI를 통해 Google Workspace와 상호작용한다.

  • gws CLI가 OAuth 토큰을 자체 관리한다.
  • Nopal 플러그인은 토큰을 직접 다루지 않는다.
  • API 키나 서비스 계정이 아닌 OAuth(사용자 인증) 방식이다.

1. 설치

전제 조건: Node.js 18 이상, npm

bash
npm install -g @googleworkspace/cli
gws --version

버전 번호가 출력되면 설치 성공.

증상해결 방법
command not found: gwsnpm config get prefix 확인 후 PATH에 추가
permission 에러sudo npm install -g @googleworkspace/cli 또는 nvm 사용
Node.js 버전 에러node --version 확인 — 18 미만이면 업그레이드

2. 초기 설정 (gws auth setup)

gws auth setup은 인터랙티브 TUI다. Codex에서 자동 실행할 수 없으므로 사용자에게 터미널에서 직접 실행하도록 안내한다.

bash
gws auth setup
5단계 가이드

Step 1/5: gcloud CLI 확인 자동 감지된다. 미설치 시: https://cloud.google.com/sdk/docs/install

Step 2/5: Google 계정 선택 사용할 Google 계정을 선택한다.

Step 3/5: GCP 프로젝트 생성 "Create new project"를 선택한다 (추천).

  • 프로젝트 ID: 소문자 영문 시작, 소문자/숫자/하이픈, 6~30자, 전 세계 유일
  • 추천 형식: nopal-ws-XXXXXX (예: nopal-ws-830621)

Step 4/5: Workspace API 선택 Nopal에 필요한 9개를 모두 선택:

  • Google Drive, Google Sheets, Gmail, Google Calendar
  • Google Docs, Google Slides, Google Tasks, Google Chat, Google Meet
  • 나머지(People, Vault, Forms, Keep 등)는 선택하지 않는다.

Step 5/5: OAuth 인증 정보 (가장 중요)

A. OAuth 동의 화면 설정:

B. 테스트 사용자 추가 (필수! 안 하면 "액세스 차단됨" 403 에러):

C. OAuth 클라이언트 ID 생성:

  • https://console.cloud.google.com/apis/credentials 이동
  • "+ 사용자 인증 정보 만들기" → "OAuth 클라이언트 ID"
  • 애플리케이션 유형: "데스크톱 앱" → 만들기
  • 생성된 Client ID와 Client Secret을 터미널에 붙여넣기

Show full SKILL.md (226 more words)Show less

3. 로그인 (gws auth login)

setup 완료 후:

bash
gws auth login
  • URL이 표시되면 직접 브라우저에 복사해서 열기 (자동으로 안 열린다).
  • "Google hasn't verified this app" 경고 → 고급 → 앱으로 이동(안전하지 않음) 클릭.
  • Google 계정으로 로그인하고 권한을 승인하면 "Authentication successful" 표시.

로그인 후 반드시 실행 (headless 환경에서 Codex가 gws를 사용하기 위해):

bash
gws auth export --unmasked 2>/dev/null | grep -v '^Using keyring' > ~/.config/gws/credentials.json
chmod 600 ~/.config/gws/credentials.json   # 평문 토큰 — 본인만 읽도록 제한하고 절대 커밋 금지

자격증명은 gws CLI가 소유한다. headless 사용을 위해 토큰을 로컬 ~/.config/gws/credentials.json(평문)으로 내보낼 뿐이며, nopal 자체에는 자격증명을 담지 않는다.

인증 확인
bash
gws auth status

정상이면 인증된 Google 계정 이메일과 활성화된 API 목록이 표시된다.


4. 인증 문제 해결

증상원인해결 방법
Token expiredOAuth 토큰 만료gws auth login 재실행 후 export + chmod 600 재실행
Invalid credentials토큰 파일 손상gws auth logout 후 재로그인
액세스 차단됨 / Access blocked (403)Test user 미등록GCP 콘솔 → Test users → 본인 이메일 추가
invalid_scope (400)스코프 과다 (25개 초과)불필요한 API 비활성화 또는 새 프로젝트 생성
No credentials provided (401)Keyring 접근 불가gws auth export --unmasked 2>/dev/null | grep -v '^Using keyring' > ~/.config/gws/credentials.json && chmod 600 ~/.config/gws/credentials.json
브라우저가 안 열림URL 자동 오픈 미지원터미널에 표시된 URL을 직접 브라우저에 붙여넣기
조직 계정 제한Google Workspace 관리자 정책관리자에게 gws CLI 앱 허용 요청
프로젝트 ID 중복이미 사용 중인 ID뒤에 랜덤 숫자를 변경하여 재시도

인증 초기화 (최후의 수단):

bash
gws auth logout
gws auth setup

5. 설치 완료 후

설치와 인증이 모두 완료되면 nopal을 다시 실행한다.

확인 체크리스트:

  • gws --version → 버전 번호 출력
  • gws auth status → 인증된 이메일 + API 목록 표시
  • nopal 재실행 → 오케스트레이션 시작

© fivetaku, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in plugins/nopal-codex/skills/nopal-setup of fivetaku/gptaku-plugins-codex.

  • SKILL.md
  • references/setup-guide.md

Open the folder on GitHubat commit d3b47fc

Compare with similar skills

Nopal Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Nopal Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Nopal Setup this skillfivetaku/gptaku-plugins-codex128—~1.1kAutomated safety check: NotesMIT
Google WorkspaceRedWoodOG/Hermes-Desktop177—~2.1kAutomated safety check: PassMIT
Implementing Google Workspace Sso Configurationmukul975/Anthropic-Cybersecurity-Skills34k—~2kAutomated safety check: PassApache-2.0
Implementing Zero Trust For SaaS Applicationsmukul975/Anthropic-Cybersecurity-Skills34k—~2.9kAutomated safety check: PassApache-2.0
API GatewayCraftOS-dev/CraftBot3923 repos~7.1kAutomated safety check: PassMIT
Detecting Email Account Compromisemukul975/Anthropic-Cybersecurity-Skills34k—~823Automated safety check: PassApache-2.0

Similar skills

  • Google Workspace

    RedWoodOG/Hermes-Desktop

    Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration via Python.

    177 GitHub stars~2.1k tokensUpdated 4 mo ago
    Backend & APIsAuto-check passed
  • Implementing Google Workspace Sso Configuration

    mukul975/Anthropic-Cybersecurity-Skills

    Configures SAML 2.0 single sign-on for Google Workspace against a third-party identity provider (Okta, Azure AD/Entra ID, ADFS), with Workspace as the Service Provider, to centralize authentication…

    34k GitHub stars~2k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Implementing Zero Trust For SaaS Applications

    mukul975/Anthropic-Cybersecurity-Skills

    Secures SaaS apps (Microsoft 365, Google Workspace, Salesforce, Slack) via CASB/SSPM deployment, conditional access policies, OAuth app governance, and session-level DLP controls enforcing identity…

    34k GitHub stars~2.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • API Gateway

    CraftOS-dev/CraftBot

    Connect to 100+ APIs (Google Workspace, Microsoft 365, Notion, Slack, Airtable, HubSpot, etc.) with managed OAuth.

    392 GitHub starsUsed in 3 repos~7.1k tokens
    Backend & APIsAuto-check passed
  • Detecting Email Account Compromise

    mukul975/Anthropic-Cybersecurity-Skills

    Detect compromised O365 and Google Workspace email accounts by analyzing Unified Audit Logs and Azure AD sign-in logs for impossible travel, inbox rule creation/deletion (Set-InboxRule…

    34k GitHub stars~823 tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • GCP Workspace Pivot

    wgpsec/AboutSecurity

    GCP 到 Google Workspace 的穿越攻击方法论。当已获取 GCP Service Account 或 Project 权限并发现目标组织使用 Google Workspace、需要从云平台穿越到企业邮件/文档/管理控制台、或发现 Domain-Wide Delegation 配置时使用。覆盖 Domain-Wide Delegation 滥用、OAuth…

    1.8k GitHub stars~2.9k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed

More from fivetaku/gptaku-plugins-codex

All 25 skills in this repo
  • Pumasi Image

    fivetaku/gptaku-plugins-codex

    Image-generation companion skill for the pumasi plugin family.

    128 GitHub stars~3.6k tokensUpdated 29 days ago
    Auto-check passed
  • Insane Research Pipeline

    fivetaku/gptaku-plugins-codex

    Runs a multi-agent deep research workflow in seven phases, from scoping questions to a final report with source triangulation, state tracking and quality ratings.

    128 GitHub stars~7.1k tokensUpdated 29 days ago
    Auto-check passed
  • Skillers Suda

    fivetaku/gptaku-plugins-codex

    This skill should be used when the user asks to "스킬 만들어줘", "에이전트 만들어줘", "커맨드 만들어줘", "스킬러들의 수다", "수다", "Codex 스킬 만들어줘", "이 스킬 분석해줘", "이 스킬 개선해줘", "skill builder", "make a skill", "create a skill"…

    128 GitHub stars~6k tokensUpdated 29 days ago
    Auto-check passed
  • Dd

    fivetaku/gptaku-plugins-codex

    A skill your agent uses when the user runs /dd or /ㅇㅇ (Hangul IME alias — typing "dd" in Korean IME produces "ㅇㅇ") to act on the current OS clipboard (text or image) without pasting it into chat.

    128 GitHub stars~2k tokensUpdated 29 days ago
    Auto-check passed
  • Insane Search

    fivetaku/gptaku-plugins-codex

    Adaptive access for blocked websites — tries every method until one works.

    128 GitHub stars~5.6k tokensUpdated 29 days ago
    Auto-check passed
  • Docs Guide

    fivetaku/gptaku-plugins-codex

    Fetch and explain official documentation for any library, framework, API, or service using an llms.txt-first strategy — triggers on "How do I…", "What is…", "How does X work", "Best practice for…"…

    128 GitHub stars~3.5k tokensUpdated 29 days ago
    Auto-check passed

Questions about Nopal Setup

What does Nopal Setup do?

Codex용 Google Workspace 설정 가이드 스킬. An agent skill from fivetaku/gptaku-plugins-codex. Nopal Setup is an agent skill from fivetaku/gptaku-plugins-codex. Codex용 Google Workspace 설정 가이드 스킬.

When should I use Nopal Setup?

Nopal Setup fits situations like: gws authentication; tasks that involve Cloud office suites; tasks that involve OAuth and OpenID Connect.

How do I install Nopal Setup in Claude Code?

Run `npx skills add fivetaku/gptaku-plugins-codex --skill nopal-setup -a claude-code`. Or copy the skill folder (plugins/nopal-codex/skills/nopal-setup in fivetaku/gptaku-plugins-codex) into .claude/skills/nopal-setup in your project. Claude Code loads it when a task matches its description.

How do I install Nopal Setup in Codex?

Run `npx skills add fivetaku/gptaku-plugins-codex --skill nopal-setup -a codex`. Or copy the skill folder (plugins/nopal-codex/skills/nopal-setup in fivetaku/gptaku-plugins-codex) into .agents/skills/nopal-setup in your project. Codex loads it when a task matches its description.

Can I use Nopal Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fivetaku/gptaku-plugins-codex --skill nopal-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/nopal-setup, .gemini/skills/nopal-setup, .github/skills/nopal-setup and .opencode/skills/nopal-setup in your project.

What does Nopal Setup need to run?

Going by SKILL.md and its folder, Nopal Setup needs the command-line tools its instructions call (npm and node). Our summary lists: Node.js.

Does Nopal Setup access the network?

SKILL.md names 2 domains. As links in the text: console.cloud.google.com and cloud.google.com. This is read from the text; nothing was executed.

Is Nopal Setup safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Nopal Setup use?

Nopal Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Nopal Setup use?

About 1.1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 838 tokens, read only when the agent opens those files.

What are the alternatives to Nopal Setup?

Skills that share tags, products or a category with Nopal Setup: Google Workspace (RedWoodOG/Hermes-Desktop, 177 stars), Implementing Google Workspace Sso Configuration (mukul975/Anthropic-Cybersecurity-Skills, 34k stars), Implementing Zero Trust For SaaS Applications (mukul975/Anthropic-Cybersecurity-Skills, 34k stars) and API Gateway (CraftOS-dev/CraftBot, 392 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Nopal Setup?

fivetaku (a GitHub user) maintains it in fivetaku/gptaku-plugins-codex, which has 128 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on September 8, 2026.

Source: fivetaku/gptaku-plugins-codex on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.