Agent skill

New

by clacky-ai in clacky-ai/openclacky

Create a new project to start development quickly. An agent skill from clacky-ai/openclacky.

MITAuto-check passed

Install New

skills CLI
$ npx skills add clacky-ai/openclacky --skill new -a claude-code

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

GitHub CLI
$ gh skill install clacky-ai/openclacky new --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/clacky-ai/openclacky.git skills-src && mkdir -p .claude/skills && cp -r skills-src/lib/clacky/default_skills/new .claude/skills/new && 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
new
GitHub stars
1.2k
Token cost
~1.2k tokens
SKILL.md length
492 words
Files
2 (incl. scripts)
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Create a new project to start development quickly. An agent skill from clacky-ai/openclacky.

  • Works in 4 steps: Ask Project Type and Requirement → Check Directory Before Starting → Run Setup Script → …
  • SKILL.md covers Usage, Process Steps, Error Handling and Example Interaction
  • Runs Shell scripts from its folder

What it does

New is an agent skill from clacky-ai/openclacky. Create a new project to start development quickly

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/create_rails_project.sh`).

The repository describes itself as: The most Token-efficient open-source AI Agent. The licence is MIT.

Example prompts

  • “/new”

Requirements

  • Node.js
  • A Bash shell

Workflow steps

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

  1. Ask Project Type and Requirement
  2. Check Directory Before Starting
  3. Run Setup Script
  4. Start Development Server

What it can do on your machine

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

    Ships 1 file in scripts/ (Shell), which the agent can run.

    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

New loads about 1.2k tokens when it runs. Until then it costs about 13 tokens; SKILL.md has 492 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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); the scripts in this folder are not scanned.

SKILL.md

The full file from clacky-ai/openclacky at commit e16b639, republished under its MIT licence (© clacky-ai). 492 words, ~1,198 tokens.

Download SKILL.mdSave it as .claude/skills/new/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
new
description
Create a new project to start development quickly
name_zh
新建项目
description_zh
快速创建一个新项目,马上开始开发。
agent
coding
disable-model-invocation
false
user-invocable
true

Create New Project

Usage

When user wants to create a new Rails project:

  • "help me create a new Rails project"
  • "I want to start a new Rails project"
  • "/new"

Process Steps

0. Ask Project Type and Requirement

Before doing anything, call ask_user with a structured prompt. Use the following as a guide:

zh:

json
{
  "question": "请选择项目类型,并用一句话描述你想做什么:",
  "context": "开始新项目前需要知道项目类型和需求,请先完成填写。",
  "options": ["⚡ Demo — 无数据库,AI 自由发挥,快速原型", "🏗️ Production — 真实应用,可部署,完整 Rails 配置"]
}

en:

json
{
  "question": "Choose a project type and describe what you want to build in one sentence:",
  "context": "Tell us what kind of project to create so we can get started.",
  "options": ["⚡ Demo — no database, AI builds freely, quick prototype", "🏗️ Production — real app, ready to deploy, full Rails setup"]
}

Based on user's choice:

  • If Demo: do NOT follow the Rails setup steps below. Instead, freely build a simple HTML/CSS/JS (or React) prototype directly in the working directory based on their requirement. Use your creativity.
  • If Production: continue with steps 1–3 below (full Rails flow).
1. Check Directory Before Starting

Before running the setup script, check if current directory is empty:

  • Use glob tool to check if directory has files: glob("*", base_path: ".")
  • If directory is NOT empty, ask user for confirmation: "Current directory is not empty. Continue anyway? (y/n)"
  • If user declines, abort and suggest creating project in an empty directory
2. Run Setup Script

Execute the create_rails_project.sh script (see Supporting Files below) in current directory. Use the exact absolute path shown in the Supporting Files section:

bash
<absolute path to create_rails_project.sh from Supporting Files>

The script will automatically:

Step 1: Clone Template

  • Clone rails-template-7x-starter to a temporary directory
  • Move all files to current directory
  • Delete template's .git directory
  • Initialize new git repository with initial commit

Step 2: Check Environment

  • Run rails_env_checker.sh to verify dependencies:
    • Ruby >= 3.3.0 (auto-installed via mise if missing or too old — supports CN mirrors)
    • Node.js >= 22.0.0 (will install automatically if missing on macOS/Ubuntu)
    • PostgreSQL (will install automatically if missing on macOS/Ubuntu)
  • Script automatically installs missing dependencies without prompting

Step 3: Install Project Dependencies

  • Run ./bin/setup to:
    • Install Ruby gems (bundle install)
    • Install npm packages (npm install)
    • Copy configuration files
    • Setup database (db:prepare)

Step 4: Project Setup Complete

  • Script completes successfully
  • Project is ready to run
Show full SKILL.md (197 more words)Show less
3. Start Development Server

After the script completes, read the .1024 config file in the project root to find the run_command, then start it in the background via the terminal tool:

# First, read .1024 to get the run_command (usually `bin/dev` for Rails):
file_reader(path: ".1024")

# Then start the server in the background:
terminal(command: "<run_command from .1024>", background: true)

Important: If the terminal call returns a session_id (and no error), the server has started successfully. You can inspect logs later by polling the same session_id with an empty input.

Then inform the user and ask what to develop next:

✨ Rails project created successfully!

The development server is now running at: http://localhost:3000

You can open your browser and visit the URL to see the application.

What would you like to develop next?

Error Handling

  • Directory not empty → Ask user confirmation, abort if declined
  • Git clone fails → Check network connection, verify repository URL
  • Ruby < 3.3 or missing → Automatically installs Ruby 3.3 via mise (with CN mirror support); exits with instructions if mise install fails
  • Node.js < 22 → Script installs automatically (macOS/Ubuntu)
  • PostgreSQL missing → Script installs automatically (macOS/Ubuntu)
  • bin/setup fails → Show error, suggest running ./bin/setup manually
  • Dev server fails to start → Poll the terminal session (empty input) to check logs, verify database status

Example Interaction

User: "/new"

Response:

  1. Checking if current directory is empty...
  2. Running create_rails_project.sh in current directory
  3. Cloning Rails template from GitHub...
  4. Checking environment dependencies...
  5. Installing project dependencies...
  6. Project setup complete!
  7. Starting development server via terminal (background)...
  8. ✨ Server running! Visit http://localhost:3000

© clacky-ai, 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 (scripts) in lib/clacky/default_skills/new of clacky-ai/openclacky.

  • SKILL.md
  • scripts/create_rails_project.sh

Open the folder on GitHubat commit e16b639

Compare with similar skills

New 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.

New compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
New this skillclacky-ai/openclacky1.2k—~1.2kAutomated safety check: PassMIT
Octopus Quicknyldn/claude-octopus4.2k1 repos~2.2kAutomated safety check: PassMIT
GSD Quick Batchopen-gsd/gsd-core10k—~1.4kAutomated safety check: NotesMIT
Quick Design SpecDonchitos/Claude-Code-Game-Studios26k—~2.9kAutomated safety check: PassMIT
Quicknotque/vexjoy-agent441—~1.9kAutomated safety check: NotesMIT
Quick RecapBuilderIO/skills4.6k—~352Automated safety check: PassMIT

Similar skills

  • Octopus Quick

    nyldn/claude-octopus

    Quick execution for ad-hoc tasks without full workflow overhead — use for small, self-contained requests

    4.2k GitHub starsUsed in 1 repo~2.2k tokens
    DevelopmentAuto-check passed
  • GSD Quick Batch

    open-gsd/gsd-core

    Runs several small /gsd-quick tasks as one batch, with a single coordinator that plans them, dispatches workers per item and owns all shared writes and worktree merges.

    10k GitHub stars~1.4k tokensUpdated today
    Agent WorkflowsAuto-check: notes
  • Quick Design Spec

    Donchitos/Claude-Code-Game-Studios

    Writes a short design spec for small gameplay adjustments such as tuning, tweaks and minor additions, and redirects anything larger to a full design document.

    26k GitHub stars~2.9k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Quick

    notque/vexjoy-agent

    Tracked lightweight execution with composable rigor flags: --trivial, --discuss, --research, --full.

    441 GitHub stars~1.9k tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Quick Recap

    BuilderIO/skills

    A skill your agent uses when adding or following the red/yellow/green final status block convention for agent responses, especially by installing managed AGENTS.md or CLAUDE.md instructions.

    4.6k GitHub stars~352 tokensUpdated yesterday
    Agent WorkflowsAuto-check passed
  • Quick Calculator

    alibaba/skill-up

    Quickly produces accurate calculation results when a user needs arithmetic, unit conversion, or mathematical formula solving.

    1.2k GitHub stars~252 tokensUpdated today
    Auto-check passed

More from clacky-ai/openclacky

All 20 skills in this repo
  • Skill Add

    clacky-ai/openclacky

    Install skills from a zip URL or local zip file path. An agent skill from clacky-ai/openclacky.

    1.2k GitHub stars~560 tokensUpdated today
    Auto-check passed
  • Media Gen

    clacky-ai/openclacky

    Generate or edit images, videos, or audio in the current task.

    1.2k GitHub stars~7.3k tokensUpdated today
    Auto-check passed
  • Browser Setup

    clacky-ai/openclacky

    Configure the browser tool for Clacky. An agent skill from clacky-ai/openclacky.

    1.2k GitHub stars~3.1k tokensUpdated today
    Auto-check: notes
  • Cron Task Creator

    clacky-ai/openclacky

    Create, manage, and run scheduled automated tasks (cron jobs) in Clacky.

    1.2k GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Deploy

    clacky-ai/openclacky

    Deploy Rails applications to Railway. An agent skill from clacky-ai/openclacky.

    1.2k GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • MCP Manager

    clacky-ai/openclacky

    Manage MCP (Model Context Protocol) servers for openclacky: add, list, probe, remove, reconfigure.

    1.2k GitHub stars~3k tokensUpdated today
    Auto-check passed

Questions about New

What does New do?

Create a new project to start development quickly. An agent skill from clacky-ai/openclacky. New is an agent skill from clacky-ai/openclacky.

How do I install New in Claude Code?

Run `npx skills add clacky-ai/openclacky --skill new -a claude-code`. Or copy the skill folder (lib/clacky/default_skills/new in clacky-ai/openclacky) into .claude/skills/new in your project. Claude Code loads it when a task matches its description.

How do I install New in Codex?

Run `npx skills add clacky-ai/openclacky --skill new -a codex`. Or copy the skill folder (lib/clacky/default_skills/new in clacky-ai/openclacky) into .agents/skills/new in your project. Codex loads it when a task matches its description.

Can I use New 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 clacky-ai/openclacky --skill new -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/new, .gemini/skills/new, .github/skills/new and .opencode/skills/new in your project.

What does New need to run?

Going by SKILL.md and its folder, New needs a shell for the scripts in its folder. Our summary lists: Node.js; A Bash shell.

Does New 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 New safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does New use?

New 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 New use?

About 1.2k tokens (SKILL.md is roughly 4.8k 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 New?

Skills that share tags, products or a category with New: Octopus Quick (nyldn/claude-octopus, 4.2k stars), GSD Quick Batch (open-gsd/gsd-core, 10k stars), Quick Design Spec (Donchitos/Claude-Code-Game-Studios, 26k stars) and Quick (notque/vexjoy-agent, 441 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains New?

clacky-ai (a GitHub organization) maintains it in clacky-ai/openclacky, which has 1,204 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 10, 2026.

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