Merge pull request #13 from pinecone-io/sync/skills

sync: skills from pinecone-io/skills

Author: arjunpatel7

skills/pinecone-assistant/.gitkeep

@@ -10,6 +10,8 @@ Pinecone Assistant is a fully managed RAG service. Upload documents, ask questio
 > All scripts are in `scripts/` relative to this skill directory.
 > Run with: `uv run scripts/script_name.py [arguments]`
 
+Whenever this skill asks the user to choose between options, confirm a destructive step, or pick from a list, ask in plain prose, list the options, and wait for their answer before continuing.
+
 ## Operations
 
 | What to do | Script | Key args |
@@ -73,6 +75,10 @@ Handle chained requests naturally. Example:
 
 ## Prerequisites
 
-- `PINECONE_API_KEY` must be available — add it to a `.env` file at your workspace root (the bundled MCP config loads it via Cursor's `envFile` field) and run scripts with `uv run --env-file .env scripts/...`. For terminal-only scripts, `export PINECONE_API_KEY="your-key"` also works.
+- `PINECONE_API_KEY` must be available:
+- Add `PINECONE_API_KEY=your-key` to a `.env` file at your workspace root. The
+  bundled MCP config reads it through Cursor's `envFile` field.
+- For scripts, either `export PINECONE_API_KEY="your-key"` in your terminal or
+  run them with `uv run --env-file .env scripts/...`.
 - `uv` must be installed — [install uv](https://docs.astral.sh/uv/getting-started/installation/)
 - Get a free API key at: https://app.pinecone.io/?sessionType=signup

skills/pinecone-assistant/SKILL.md

@@ -131,8 +131,8 @@ def main(
 
             # Suggest next action
             next_action = f"""[bold]Next steps:[/bold]
-• Ask a question: [cyan]/pinecone:assistant-chat assistant {assistant} message [your question][/cyan]
-• Upload more files: [cyan]/pinecone:assistant-upload assistant {assistant} source [path][/cyan]"""
+• Ask a question: [cyan]uv run chat.py --assistant {assistant} --message "YOUR QUESTION"[/cyan]
+• Upload more files: [cyan]uv run upload.py --assistant {assistant} --source PATH[/cyan]"""
             console.print(Panel(next_action, title="What's Next?", border_style="green"))
 
     except AttributeError as e:
@@ -141,7 +141,7 @@ def main(
         console.print(f"[dim]Details: {e}[/dim]")
         console.print("\n[yellow]Note:[/yellow] Context API requires SDK version with assistant.context() support")
         console.print("\n[yellow]Try using chat instead:[/yellow]")
-        console.print(f"  /pinecone:assistant-chat assistant {assistant} message \"{query}\"")
+        console.print(f"  uv run chat.py --assistant {assistant} --message \"{query}\"")
         raise typer.Exit(1)
     except Exception as e:
         console.print(f"[red]Error: {e}[/red]")

skills/pinecone-assistant/references/.gitkeep

@@ -112,9 +112,9 @@ def main(
 
         # Next steps
         next_steps = f"""[bold]Next steps:[/bold]
-1. Upload files: [cyan]/pinecone:assistant-upload assistant {name} source [path][/cyan]
-2. Chat: [cyan]/pinecone:assistant-chat assistant {name} message [your question][/cyan]
-3. Get context: [cyan]/pinecone:assistant-context assistant {name} query [search][/cyan]"""
+1. Upload files: [cyan]uv run upload.py --assistant {name} --source PATH[/cyan]
+2. Chat: [cyan]uv run chat.py --assistant {name} --message "YOUR QUESTION"[/cyan]
+3. Get context: [cyan]uv run context.py --assistant {name} --query "SEARCH TEXT"[/cyan]"""
 
         console.print(Panel(next_steps, title="What's Next?", border_style="green"))
 

skills/pinecone-assistant/scripts/.gitkeep

@@ -61,7 +61,7 @@ def main(
             else:
                 console.print("[yellow]No assistants found.[/yellow]\n")
                 console.print("Create your first assistant with:")
-                console.print("  [cyan]/pinecone:assistant-create name [assistant-name][/cyan]")
+                console.print("  [cyan]uv run create.py --name ASSISTANT_NAME[/cyan]")
             return
 
         if json_output:
@@ -195,10 +195,10 @@ def main(
 
             # Next steps panel
             next_steps = """[bold]Next steps:[/bold]
-• List with files: [cyan]/pinecone:assistant-list --files[/cyan]
-• Chat: [cyan]/pinecone:assistant-chat assistant [name] message [your question][/cyan]
-• Upload: [cyan]/pinecone:assistant-upload assistant [name] source [path][/cyan]
-• Context: [cyan]/pinecone:assistant-context assistant [name] query [search][/cyan]"""
+• List with files: [cyan]uv run list.py --files[/cyan]
+• Chat: [cyan]uv run chat.py --assistant NAME --message "YOUR QUESTION"[/cyan]
+• Upload: [cyan]uv run upload.py --assistant NAME --source PATH[/cyan]
+• Context: [cyan]uv run context.py --assistant NAME --query "SEARCH TEXT"[/cyan]"""
 
             console.print(Panel(next_steps, title="Available Commands", border_style="blue"))
 

skills/pinecone-assistant/scripts/chat.py

@@ -208,8 +208,8 @@ def main(
         # Next steps
         if uploaded > 0:
             next_steps = f"""[bold]Next steps:[/bold]
-• Chat: [cyan]/pinecone:assistant-chat assistant {assistant} message [your question][/cyan]
-• Context: [cyan]/pinecone:assistant-context assistant {assistant} query [search][/cyan]
+• Chat: [cyan]uv run chat.py --assistant {assistant} --message "YOUR QUESTION"[/cyan]
+• Context: [cyan]uv run context.py --assistant {assistant} --query "SEARCH TEXT"[/cyan]
 
 [dim]Note: Files are being processed and will be available shortly[/dim]"""
             console.print(Panel(next_steps, title="What's Next?", border_style="green"))