new-skill

new-skill is a skill for Claude Code, Codex from remorses/kimaki. It costs 61 tokens per session (3,498 once invoked), scanned C, original, MIT.

A guide to creating a SKILL.md file, the instruction file that teaches an AI coding agent a specific workflow or capability. It explains the expected structure, writing style, location, and supporting files.

In plain words
What is it for?
Use it to create or update a skill, choose its folder and filename, write its instructions, and add related scripts, templates, or references.
Why use it?
It reduces uncertainty about how to package instructions so the agent can find and use them correctly. It also distinguishes shared repository skills from personal skills on one machine.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: mentions Claude Code; mentions OpenCode.

Good fit Use it to create or update a skill, choose its folder and filename, write its instructions, and add related scripts, templates, or references.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/remorses/kimaki/new-skill
About the project

Kimaki is a Discord-based orchestrator for OpenCode, an AI coding agent that edits files on a user's machine. It maps each project to a Discord channel and each coding session to a thread, allowing users to start, resume, search, and fork work through conversations. Catalogue add-ons provide Kimaki-related workflows for coding agents.

remorses/kimaki · 1,400 stars · on GitHub · kimaki.dev

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add remorses/kimaki --skill new-skill
Clone the repo
git clone --depth 1 https://github.com/remorses/kimaki

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for new-skill

README.md
[![agentmods](https://agentmods.dev/badge/skills/remorses/kimaki/new-skill.svg)](https://agentmods.dev/skills/remorses/kimaki/new-skill)
Your own site
<a href="https://agentmods.dev/skills/remorses/kimaki/new-skill"><img src="https://agentmods.dev/badge/skills/remorses/kimaki/new-skill.svg" alt="Measured on agentmods" height="20"></a>
Per session 61 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,498 The whole file, excluding the scripts and references it only reads on demand.
Security scan C 2 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector warn 7 Sept 2026
SkillSpector: 10 findings, up to high

These are SkillSpector’s own severities. On a checked sample its high-severity flags on skills were ~96% false positives — a documented command, a public API, a “never do X” rule — so we show them as a caution to read, not a verdict. Why →

  • high Prompt Injection · line 218
    Hidden instructions were detected in comments or invisible text. These could contain malicious directives. Manual review is recommended.
    Fix: Audit all comments and invisible characters. Remove any instructions that direct the agent to perform unauthorized actions. Use plain, reviewable content.
  • medium Rogue Agent · line 7
    Skill establishes unauthorized persistence across sessions via cron jobs, startup scripts, or state files. Session persistence allows an attacker to maintain access beyond the current interaction.
    Fix: Remove any persistence mechanisms (cron jobs, startup scripts, state files). Skills should not maintain state across sessions without explicit user consent.
  • medium Agent Snooping · line 23
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
  • medium Agent Snooping · line 23
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
  • medium MCP Rug Pull · line 48
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 70
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 168
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium MCP Rug Pull · line 57
    npx commands without a version suffix (e.g. @1.0.0) create a rug-pull risk if the upstream server is compromised and publishes a malicious update.
    Fix: Pin the version: npx @scope/[email protected]
  • medium Agent Snooping · line 102
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
  • medium Agent Snooping · line 135
    Skill enumerates or reads other installed skills. Access to other skills' SKILL.md files or the skills directory reveals prompt instructions, capabilities, and secrets that should be invisible to peer skills.
    Fix: Remove all code or instructions that list or read other skills' files or directories. Skills should operate independently; cross-skill access is a privilege escalation.
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00061 $0.03498
Opus 5 $0.00030 $0.01749
Sonnet 5 $0.00012 $0.00700
Haiku 4.5 $0.00006 $0.00350

Measured 8d ago against content hash 2bcbfb734471, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-07, from the pricing page.

Security

Grade C, and why

new-skill scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 8d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Hidden instructionshighPrompt injection

Directives inside HTML comments, invisible characters or bidirectional overrides are read by the model and not by the person reviewing the file.

- **Do not add HTML comments.** Skills are instructions, not generated files. Avoid comments like `<!-- Skill instructions for agents using ... -->`.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

**2. Libraries and projects → curl the raw README**
skills/new-skill/SKILL.md · 340 lines

How it starts

The opening of the file, as written. The whole thing — 340 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Creating a SKILL.md

A skill is a markdown file that teaches an AI agent a specific workflow, tool, or pattern. Skills are loaded into context when the agent recognizes a task that matches the skill's description.

File location

Place the skill in a top-level skills/ folder at the repository root:

skills/<skill-name>/SKILL.md

For example: skills/critique/SKILL.md, skills/errore/SKILL.md.

Do not put skills inside package folders like cli/skills/, website/skills/, or packages/foo/skills/ unless the repository intentionally syncs or mirrors them there for internal tooling. The canonical repository layout for a skill you are creating is always the root-level skills/ directory.

The folder name should match the skill name in kebab-case. Each skill gets its own folder so it can include companion files if needed (scripts, templates, references).

For personal skills that follow you across all repos and are not meant for distribution in a GitHub repository, place them in:

~/.config/opencode/skills/<skill-name>/SKILL.md

Personal skills are only available on your machine. Repository skills are shared with everyone who clones the repo.

Editing skills synced from other repositories

Some projects (like kimaki) sync skills from external GitHub repositories into a local skills folder. If a skill was synced from another repo, never edit the synced copy. The synced folder is overwritten on every sync and your changes will be lost.

Instead, find the source repository where the skill originates and edit the SKILL.md there. The sync process will pick up the changes on the next run. If you are unsure which repo a skill comes from, check for a sync script (e.g. scripts/sync-skills.ts) or a source-repo field in the skill's frontmatter.

Distribution and installation

When you publish skills in a GitHub repository, other users can install them with the skills CLI:

npx skills add owner/repo

This downloads the skills from the repo and symlinks them into the user's agent directories. Add this to your repo's README so users know how to install:

Read the full file on GitHub · 340 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 8d ago First seen · 340 lines · 61 tokens per session scan C 2bcbfb734471

Subscribe to this mod's changes

new-skill is a skill published in the GitHub repository remorses/kimaki (1,400 stars, last pushed 2d ago), licensed MIT. It adds 61 tokens to every session and 3,498 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it C with 2 findings (hidden instructions, makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

browser-use

Automates browser interactions for social media management across Instagram, LinkedIn, and X. Handles posting, DMs, connection requests, lead scraping, and monitoring. Use when the user needs to navigate, interact with, or extract data from approved websites.

wanikua/danghuangshang · 53 tokens

self-improvement

Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Claude ('No, that's wrong...', 'Actually...'), (3) User requests a capability that doesn't exist, (4) An external API or tool fails, (5) Claude realizes its knowledge…

wanikua/danghuangshang · 102 tokens

novel-prose

A fiction-writing guide for creating novel chapters scene by scene, with rules for viewpoint, dialogue, description, pacing, and chapter structure.

wanikua/danghuangshang · 40 tokens

novel-openviking

Instructions for connecting a novel-writing workflow to OpenViking, a semantic memory system that stores and retrieves related information by meaning. It maps character details, world rules, chapter summaries, and plot clues to memory operations.

wanikua/danghuangshang · 63 tokens

novel-archiving

A writing-workflow skill for archiving each completed novel chapter. It creates a chapter summary and updates files that record characters, plot clues, the timeline, relationships, and world details.

wanikua/danghuangshang · 44 tokens

novel-memory

A file-based memory system for Chinese-language fiction projects. It stores story plans, character details, world rules, timelines, relationships, chapter summaries, and unresolved clues.

wanikua/danghuangshang · 51 tokens