New
DevelopmentnewNew is an Agent Skill for development published in the clacky-ai/openclacky repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Create a new project to start development quickly
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/clacky-ai/openclacky/blob/HEAD/lib/clacky/default_skills/new/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/new, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
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, use request_user_feedback to ask the user two things:
project_type: "demo" or "production"
requirement: one-sentence description of what they want to build
Card content:
- Title: "š New Project"
- Two options for project type:
- ā” Demo ā no database, AI builds freely, quick prototype
- šļø Production ā real app, ready to deploy, full Rails setup
- One text input: "Describe your project in one sentence"
- Confirm button: "Let's go!"
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:
<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
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/setupmanually - Dev server fails to start ā Poll the terminal session (empty input) to check logs, verify database status
Example Interaction
User: "/new"
Response:
- Checking if current directory is empty...
- Running create_rails_project.sh in current directory
- Cloning Rails template from GitHub...
- Checking environment dependencies...
- Installing project dependencies...
- Project setup complete!
- Starting development server via terminal (background)...
- ⨠Server running! Visit http://localhost:3000