New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Moai Jev Skill Suggestion

by modu-ai in modu-ai/moai-adk

Guidance for a display-only skill-suggestion capability: how a caller should suggest a skill to the operator, how the emitted answer is read, and what must never happen (selection, auto-loading…

Apache-2.0Auto-check: notesDevelopment

Install Moai Jev Skill Suggestion

skills CLI
$ npx skills add modu-ai/moai-adk --skill moai-jev-skill-suggestion -a claude-code

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

GitHub CLI
$ gh skill install modu-ai/moai-adk moai-jev-skill-suggestion --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/modu-ai/moai-adk.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/moai-jev-skill-suggestion .claude/skills/moai-jev-skill-suggestion && 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
moai-jev-skill-suggestion
GitHub stars
1.2k
Token cost
~1.3k tokens
SKILL.md length
711 words
Files
1
Skills in repo
48
Repo updated
First seen
Licence
Apache-2.0

At a glance

Guidance for a display-only skill-suggestion capability: how a caller should suggest a skill to the operator, how the emitted answer is read, and what must never happen (selection, auto-loading…

  • Works in 6 steps: Log each decision, and announce once per… → Filter non-task origins. A prompt typed… → Filter invocation-disabled skills. A… → …
  • Development work in your project
  • SKILL.md covers The gate comes first, What a suggestion is, The loading mechanisms… and Operational checklist (for…, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Moai Jev Skill Suggestion is an agent skill from modu-ai/moai-adk. Guidance for a display-only skill-suggestion capability: how a caller should suggest a skill to the operator, how the emitted answer is read, and what must never happen (selection, auto-loading, judgment). The capability gate ships off; this skill carries mechanism and contract ONLY — never the call path; where and how to reach the capability is the catalogue's concern.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development. The repository describes itself as: Agentic development harness for Claude Code — SPEC-driven plan/run/sync, TRUST 5 quality gates, model+effort routing, and Claude×GLM multi-LLM cost control. Single Go binary, 16… The licence is Apache-2.0.

When your agent uses it

  • Development work in your project

Example prompts

  • “/moai-jev-skill-suggestion”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Log each decision, and announce once per session that suggestion logging
  2. Filter non-task origins. A prompt typed by the operator is not a task
  3. Filter invocation-disabled skills. A skill marked
  4. Cache the roster and skill bodies per session; re-reading listings and
  5. Guard against duplicate injection: a skill already present in context is
  6. Canonicalize names: a display name and a directory id are two spellings

What it can do on your machine

Read from SKILL.md and the folder at commit 2aab5f7. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    No URLs in SKILL.md.

    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

Moai Jev Skill Suggestion loads about 1.3k tokens when it runs. Until then it costs about 100 tokens; SKILL.md has 711 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~100
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k

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.

  • NoteMentions a .env fileSKILL.md:35
    file referenced by convention (`~/.moai/.env.typesafe`, read by

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 modu-ai/moai-adk at commit 2aab5f7, republished under its Apache-2.0 licence (© modu-ai). 711 words, ~1,339 tokens.

Download SKILL.mdSave it as .claude/skills/moai-jev-skill-suggestion/SKILL.md (or your agent's skills folder).
name
moai-jev-skill-suggestion
description
Guidance for a display-only skill-suggestion capability: how a caller should suggest a skill to the operator, how the emitted answer is read, and what must never happen (selection, auto-loading, judgment). The capability gate ships off; this skill carries mechanism and contract ONLY — never the call path; where and how to reach the capability is the catalogue's concern.
when_to_use
Use when designing, reviewing, or wiring anything that suggests a skill to the operator from a model signal — consumer authors, reviewers of display-only…
user-invocable
true
metadata.version
1.0.0
metadata.category
reference
metadata.status
active

Skill Suggestion, Display-Only

The gate comes first

The capability is gated behind workflow.jev.enabled, and the shipped default is off. Confirm the gate before anything else. With the gate off, a caller constructs no request, makes no network call, and proceeds with no signal: an absent signal is NO SIGNAL — the same as "we did not ask" — never a negative answer, and never a reason to change course.

Three readiness surfaces exist for the on state: the gate key itself, the credentials file referenced by convention (~/.moai/.env.typesafe, read by the credential loader — never inlined, never copied into settings), and the doctor readiness check (a TCP-only probe that reports gate, credential, and reachability in three lines without sending any judgment request). A caller that cannot confirm all three proceeds as if the gate were off.

The reachable surface itself lives in the product catalogue, not here. This skill owns mechanism and contract only; the catalogue owns where the call lives.

What a suggestion is

A suggestion is a signal a person reads: a labelled model answer that names a skill that might be worth loading and carries a confidence, and it does nothing else. Four things it is not:

  • Not a selection. The existing selector keeps its selection authority; a suggestion never flips it.
  • Not an auto-load. No skill content is loaded, attached, or injected because a suggestion was emitted.
  • Not a judgment. Not a completion decision, not a merge approval, not a queue mutation — anything hard to undo stays with people.
  • Not a code-path input. Nothing branches on the answer; a human reads it, and the reading is the only consumer.

The loading mechanisms rejected here

Two mechanisms were evaluated and rejected; recording them keeps them from returning quietly:

  • Hiding the listing and injecting a chosen SKILL.md body directly. This breaks the display-only chain: a skill that never appeared in context has no reading human, and a direct content injection is precisely the auto-load the contract forbids.
  • An ambient function-hook wiring that evaluates a suggestion on every prompt. It commercializes a model call per prompt on an unmeasured behavior, fragments the template distribution, and rides an early-experiment surface that can shift without notice. Not adopted. Revisit only with measured evidence that a constant-answer baseline has been beaten — the measurement bar belongs to a separate track, not to this skill.
Show full SKILL.md (323 more words)Show less

Operational checklist (for when a caller exists)

Every item below is guidance conditioned on a caller existing — it ships no behavior:

  1. Log each decision, and announce once per session that suggestion logging is active — one visible line per session, not a chorus per call.
  2. Filter non-task origins. A prompt typed by the operator is not a task event; only genuine task origins may produce a suggestion.
  3. Filter invocation-disabled skills. A skill marked disable-model-invocation stays invisible to suggestions; the filter runs before the call, never after the answer.
  4. Cache the roster and skill bodies per session; re-reading listings and bodies on every prompt is the waste a session cache exists to prevent.
  5. Guard against duplicate injection: a skill already present in context is never suggested to appear again. Check what is loaded before showing a name.
  6. Canonicalize names: a display name and a directory id are two spellings of one skill; map both through one canonical form before deduplicating, logging, or displaying.

Question design is a separate discipline

The suggestion call is a judgment over a typed question, and typed questions carry their own rules — compute the question in code, always admit a no-match answer, keep the supplied state small, phrase both polarities. Those rules live in the question-design reference skill; this skill does not restate them. The measurement regime above the surface is likewise owned elsewhere: this skill records the contract, never baseline numbers.

What this skill is not

This skill is not a capability. It ships no caller, registers no command, adds no hook, and changes no setting. It is not a verdict: suggestion answers never close cards, approve merges, or mutate queues. And it is not an availability promise: the gate ships off, and nothing in this skill makes a suggestion surface exist — the checklist above governs only if a caller is ever built elsewhere, and until then an absent suggestion is just NO SIGNAL.

© modu-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/moai-jev-skill-suggestion of modu-ai/moai-adk.

Open the folder on GitHubat commit 2aab5f7

Compare with similar skills

Moai Jev Skill Suggestion 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.

Moai Jev Skill Suggestion compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Moai Jev Skill Suggestion this skillmodu-ai/moai-adk1.2k—~1.3kAutomated safety check: NotesApache-2.0
Vercel Composition Patternssupabase/supabase111k58 repos~726Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers297k5 repos~1.9kAutomated safety check: PassMIT
Typescript Advanced Typesrolling-scopes/rsschool-app10k25 repos~4.2kAutomated safety check: PassMPL-2.0
PR Babysitteropeninterpreter/openinterpreter69k3 repos~4.2kAutomated safety check: PassApache-2.0
Code Review ChecklistshareAI-lab/learn-claude-code78k4 repos~1.1kAutomated safety check: PassMIT

Similar skills

  • Vercel Composition Patterns

    supabase/supabase

    Official

    React composition patterns that scale. An agent skill from supabase/supabase.

    111k GitHub starsUsed in 58 repos~726 tokens
    DevelopmentAuto-check passed

  • Finishing a Development Branch

    obra/superpowers

    Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    297k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed

  • Typescript Advanced Types

    rolling-scopes/rsschool-app

    Master TypeScript's advanced type system including generics, conditional types, mapped types, template literals, and utility types for building type-safe applications.

    10k GitHub starsUsed in 25 repos~4.2k tokens
    DevelopmentAuto-check passed

  • PR Babysitter

    openinterpreter/openinterpreter

    Watches an open GitHub pull request until it merges, handling review comments, diagnosing CI failures and retrying flaky checks along the way.

    69k GitHub starsUsed in 3 repos~4.2k tokens
    DevelopmentAuto-check passed

  • Code Review Checklist

    shareAI-lab/learn-claude-code

    Reviews code against a five-part checklist covering security, correctness, performance, maintainability and testing, and reports findings in a fixed format.

    78k GitHub starsUsed in 4 repos~1.1k tokens
    DevelopmentAuto-check passed

  • Greploop

    onyx-dot-app/onyx

    Iteratively improves a PR (GitHub), MR (GitLab), or shelved changelist (Perforce) until Greptile gives it a 5/5 confidence score with zero unresolved comments.

    32k GitHub starsUsed in 4 repos~3.3k tokens
    DevelopmentAuto-check passed

More from modu-ai/moai-adk

All 48 skills in this repo

  • SVG Technical Infographic Author

    modu-ai/moai-adk

    Builds hand-editable SVG diagrams from computed layout coordinates, lints the source and renders a 2x PNG, with rules for when mermaid is the better choice.

    1.2k GitHub stars~5.2k tokensUpdated yesterday
    Auto-check: notes

  • MoAI Foundation Core

    modu-ai/moai-adk

    Reference for MoAI-ADK's core development principles: TRUST 5 quality gates, SPEC-first domain-driven workflow, agent delegation and token budgeting.

    1.2k GitHub stars~5k tokensUpdated yesterday
    Auto-check passed

  • MoAI SPEC Workflow

    modu-ai/moai-adk

    Manages SPEC documents for MoAI-ADK development, with GEARS or EARS requirement notation, acceptance criteria and a link into the Plan-Run-Sync workflow.

    1.2k GitHub stars~5.1k tokensUpdated yesterday
    Auto-check passed

  • MoAI TDD Workflow

    modu-ai/moai-adk

    Drives test-first development through the RED, GREEN, REFACTOR cycle, with a config switch that selects between TDD and a DDD workflow for existing code.

    1.2k GitHub stars~3.1k tokensUpdated yesterday
    Auto-check passed

  • MoAI Worktree Management

    modu-ai/moai-adk

    Gives each SPEC its own Git worktree with a registry of active workspaces, base-branch sync and cleanup of merged ones, inside the MoAI-ADK workflow.

    1.2k GitHub stars~3.9k tokensUpdated yesterday
    Auto-check passed

  • CI Watch and Auto-Fix Loop

    modu-ai/moai-adk

    Watches a pull request's CI checks after creation, separates required from auxiliary failures, applies limited safe fixes and escalates anything semantic to you.

    1.2k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check: notes

Categories

Questions about Moai Jev Skill Suggestion

What does Moai Jev Skill Suggestion do?

Guidance for a display-only skill-suggestion capability: how a caller should suggest a skill to the operator, how the emitted answer is read, and what must never happen (selection, auto-loading…. Moai Jev Skill Suggestion is an agent skill from modu-ai/moai-adk. Guidance for a display-only skill-suggestion capability: how a caller should suggest a skill to the operator, how the emitted answer is read, and what must never happen (selection, auto-loading, judgment).

When should I use Moai Jev Skill Suggestion?

Moai Jev Skill Suggestion fits situations like: development work in your project.

How do I install Moai Jev Skill Suggestion in Claude Code?

Run `npx skills add modu-ai/moai-adk --skill moai-jev-skill-suggestion -a claude-code`. Or copy the skill folder (.claude/skills/moai-jev-skill-suggestion in modu-ai/moai-adk) into .claude/skills/moai-jev-skill-suggestion in your project. Claude Code loads it when a task matches its description.

How do I install Moai Jev Skill Suggestion in Codex?

Run `npx skills add modu-ai/moai-adk --skill moai-jev-skill-suggestion -a codex`. Or copy the skill folder (.claude/skills/moai-jev-skill-suggestion in modu-ai/moai-adk) into .agents/skills/moai-jev-skill-suggestion in your project. Codex loads it when a task matches its description.

Can I use Moai Jev Skill Suggestion 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 modu-ai/moai-adk --skill moai-jev-skill-suggestion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/moai-jev-skill-suggestion, .gemini/skills/moai-jev-skill-suggestion, .github/skills/moai-jev-skill-suggestion and .opencode/skills/moai-jev-skill-suggestion in your project.

What does Moai Jev Skill Suggestion need to run?

SKILL.md names no scripts, command-line tools or credentials: Moai Jev Skill Suggestion is instructions for the agent only.

Does Moai Jev Skill Suggestion access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Moai Jev Skill Suggestion safe to install?

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

What licence does Moai Jev Skill Suggestion use?

Moai Jev Skill Suggestion is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Moai Jev Skill Suggestion use?

About 1.3k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Moai Jev Skill Suggestion?

Skills that share tags, products or a category with Moai Jev Skill Suggestion: Vercel Composition Patterns (supabase/supabase, 111k stars), Finishing a Development Branch (obra/superpowers, 297k stars), Typescript Advanced Types (rolling-scopes/rsschool-app, 10k stars) and PR Babysitter (openinterpreter/openinterpreter, 69k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Moai Jev Skill Suggestion?

modu-ai (a GitHub organization) maintains it in modu-ai/moai-adk, which has 1,230 GitHub stars. The repository holds 48 skills in this directory. The repository was last updated on October 9, 2026.

Source: modu-ai/moai-adk on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.