add skills files

.gitignore

@@ -3,3 +3,6 @@ target/
 scratch.md
 *claude
 *.zip
+.codex/
+.popcorn/
+.DS_Store

AGENTS.md

@@ -0,0 +1,10 @@
+## Skills
+A skill is a local instruction bundle stored in `SKILL.md`.
+
+### Available skills
+- popcorn-submission-workflow: Helps with Popcorn CLI registration, submission setup, submission modes, and file directives. (file: /Users/ben/code/popcorn-cli/.popcorn/skills/popcorn-submission-workflow/SKILL.md)
+
+### How to use skills
+- Load the skill by reading its `SKILL.md` file when user requests match the description.
+- Follow progressive disclosure: read only relevant referenced files/scripts as needed.
+- Keep the workspace setup aligned with `popcorn setup`.

README.md

@@ -70,6 +70,17 @@ We regularly run competitions with clear due dates but for beginners we will alw
 
 ## Commands
 
+### Setup
+
+Bootstrap a project with Popcorn skill scaffolding and a submission template. You can overwrite existing files with `--force`.
+
+```bash
+# Create project skill scaffolding + submission.py
+popcorn setup
+```
+
+This will create a new agent skill based on the [templates](templates/setup) and add it to your `.claude/skills` or `.codex/skills` directory.
+
 ### Submit
 
 Submit a solution to a leaderboard. Supports both TUI (interactive) and plain modes.

src/cmd/mod.rs

@@ -6,6 +6,7 @@ use std::path::PathBuf;
 
 mod admin;
 mod auth;
+mod setup;
 mod submissions;
 mod submit;
 
@@ -103,6 +104,8 @@ enum SubmissionsAction {
 
 #[derive(Subcommand, Debug)]
 enum Commands {
+    /// Bootstrap this project with Popcorn agent skills and a submission template
+    Setup,
     Reregister {
         #[command(subcommand)]
         provider: AuthProvider,
@@ -149,6 +152,7 @@ enum Commands {
 
 pub async fn execute(cli: Cli) -> Result<()> {
     match cli.command {
+        Some(Commands::Setup) => setup::run_setup().await,
         Some(Commands::Reregister { provider }) => {
             let provider_str = match provider {
                 AuthProvider::Discord => "discord",