📦 Open Source Publisher Skill

An AI Agent / Codex skill designed to publish arbitrary local code, scripts, tools, or project folders to GitHub as clean, professional open source repositories.

This skill automates the practical tasks of a release workflow: inspecting the local project, adding appropriate scaffolding (such as standard READMEs, MIT licenses, and configured .gitignore files), scanning files for sensitive information, initializing or updating Git repositories, creating public GitHub repositories via gh CLI or the GitHub API, and pushing the code up to GitHub.

---

✨ Features

• 💡 Scope & Context Auto-Discovery: Intelligently identifies what files and folders are part of the target release without mixing in unrelated sibling files.
• 🛡️ Sensitive Data Scanner: Scans the codebase for exposed passwords, keys, tokens, or credentials using optimized tools (excluding Git files) before publishing.
• 📝 Publication Scaffolding: Drafts and customizes high-quality, practical README.md, LICENSE (defaulting to MIT), and .gitignore files for various environments (Python, Node.js, C#, etc.).
• ⚙️ Automated Git Control: Automatically runs local git repository setup, sets remote paths, names default branches (main), and creates initial publication commits.
• 🚀 One-Step GitHub Creation: Seamlessly integrates with the GitHub CLI (gh) or falls back to using the GitHub REST API (using local credentials securely) to spin up a new repository and push the codebase.

---

⚙️ Installation

To install this skill in your Gemini, Antigravity, or Codex environment:

1. Clone or download this repository.
2. Copy this plugin directory into your local user plugins folder:

   # Linux/macOS
   mkdir -p ~/.gemini/config/plugins/open-source-publisher
   cp -r ./* ~/.gemini/config/plugins/open-source-publisher/
   
   # Windows (PowerShell)
   New-Item -ItemType Directory -Force -Path "$HOME\.gemini\config\plugins\open-source-publisher"
   Copy-Item -Recurse -Force -Path ".\*" -Destination "$HOME\.gemini\config\plugins\open-source-publisher"

3. Restart or refresh your AI coding assistant.

---

🛠️ Usage

To invoke the skill, prompt your AI coding assistant:

Use $open-source-publisher to publish this project as open source.

Or ask the agent directly to open source your current local tool. The system will automatically map the query to this skill definition and execute the recommended workflow.

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.