skill-distill 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2024-01-20
+
+### Added
+- Initial release
+- CLI commands: `distill`, `list`, `init`
+- Multi-platform support: Claude Code, Codex CLI, Cursor
+- Session loaders for reading conversation history
+- LLM-powered distillation using Claude API
+- Skill template generation with YAML frontmatter
+- User prompt handling with Chinese/English support
+- Platform-specific formatters and installers
+- Interactive mode for session selection
+- Configuration management via `~/.skill-distill/config.json`
+- Comprehensive test suite with 49 tests
+- GitHub CI workflow for automated testing and publishing

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Skill Distill Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# Skill Distill 🪄
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm version](https://badge.fury.io/js/skill-distill.svg)](https://badge.fury.io/js/skill-distill)
+
+**Skill Distill** is a powerful CLI tool that transforms your AI agent conversation histories into reusable, high-quality "Skills". By analyzing successful interactions, it extracts the essence of complex tasks and generates structured documentation and configurations that can be instantly re-used by Claude Code, Codex CLI, and Cursor.
+
+## Why Skill Distill?
+
+AI agents are excellent at solving complex problems, but the solutions often remain trapped within single chat sessions. When you encounter a similar problem later, you frequently have to start from scratch. 
+
+Skill Distill closes this loop by:
+- **Preserving Expertise**: Captures the "how-to" from successful agent runs.
+- **Ensuring Consistency**: Standardizes multi-step processes across your projects.
+- **Multi-Platform Portability**: Converts skills between different AI agent formats effortlessly.
+
+---
+
+## Features
+
+- 🔄 **Multi-Platform Support**: Seamlessly work with Claude Code, Codex CLI, and Cursor.
+- 🧠 **Smart Extraction**: Uses Claude API to analyze sessions and extract parameters, steps, and requirements.
+- 🛠️ **Automated Installation**: Directly install generated skills into your local agent's project directory.
+- 💬 **Interactive Mode**: Easily select sessions and provide additional context for the distillation process.
+- 📂 **Multiple Formats**: Export skills to `claude`, `codex`, or `cursor` formats.
+- 🛡️ **Validation**: Built-in validation ensures generated skills meet platform requirements.
+
+---
+
+## Installation
+
+Install Skill Distill globally via npm:
+
+```bash
+npm install -g skill-distill
+```
+
+*Note: Requires Node.js >= 18.0.0*
+
+---
+
+## Quick Start
+
+1. **Initialize your configuration**:
+   ```bash
+   skill-distill init
+   ```
+
+2. **List your recent agent sessions**:
+   ```bash
+   skill-distill list
+   ```
+
+3. **Distill your latest session**:
+   ```bash
+   skill-distill distill --last --install
+   ```
+
+---
+
+## CLI Commands Reference
+
+### `skill-distill distill [session]`
+
+The main command to extract a Skill from a session history.
+
+| Option | Shorthand | Description |
+| :--- | :--- | :--- |
+| `[session]` | - | Optional session ID to distill |
+| `--last` | `-l` | Use the most recent session from the default platform |
+| `--session <id>` | `-s` | Specify a specific session ID |
+| `--prompt <text>` | `-p` | Add custom user instructions (can be used multiple times) |
+| `--format <type>`| `-f` | Output format: `claude`, `codex`, `cursor`, or `all` (Default: `claude`) |
+| `--output <dir>` | `-o` | Target directory for generated files (Default: `~/.skills`) |
+| `--install` | - | Automatically install the skill to the local agent's path |
+| `--interactive` | `-i` | Enable interactive session selection and prompt collection |
+| `--verbose` | `-v` | Show detailed processing logs |
+
+### `skill-distill list`
+
+List available sessions from your AI agent history.
+
+| Option | Shorthand | Description |
+| :--- | :--- | :--- |
+| `--limit <n>` | `-n` | Number of sessions to display (Default: 20) |
+| `--platform <t>`| - | Filter sessions by platform: `claude`, `codex`, `cursor` |
+
+### `skill-distill init`
+
+Interactive setup to configure your environment, including:
+- Default AI Agent platform
+- Claude API Key (for LLM-powered distillation)
+- Default output directory
+- Auto-installation preferences
+
+---
+
+## Configuration
+
+Skill Distill stores its configuration in `~/.skill-distill/config.json`. 
+
+```json
+{
+  "defaultPlatform": "claude",
+  "apiKey": "sk-ant-...",
+  "outputDir": "/Users/user/.skills",
+  "autoInstall": true,
+  "sessionSources": {
+    "claude": "/Users/user/.claude/projects"
+  }
+}
+```
+
+- **apiKey**: Your Anthropic API key. This is required for the distillation process to analyze message history.
+- **defaultPlatform**: The agent platform you use most frequently.
+- **outputDir**: Where generated markdown and configuration files are saved.
+
+---
+
+## Examples
+
+### Distill with extra context
+If you want the distilled skill to focus specifically on certain aspects (e.g., error handling), you can provide extra prompts:
+```bash
+skill-distill distill --last -p "Ensure we include detailed error handling for API failures"
+```
+
+### Batch format export
+Export a session as a skill compatible with all supported platforms:
+```bash
+skill-distill distill <session-id> --format all --output ./my-team-skills
+```
+
+### Interactive selection
+Don't remember the session ID? Use interactive mode:
+```bash
+skill-distill distill --interactive
+```
+
+---
+
+## Output Formats
+
+| Format | Extension | Target |
+| :--- | :--- | :--- |
+| **Claude** | `.md` | Claude Code Skills (Custom Instructions) |
+| **Codex** | `.yaml` | Codex CLI Commands/Workflows |
+| **Cursor** | `.cursorrules`| Cursor project-specific rules |
+
+---
+
+## Development
+
+We use `pnpm` for package management and `tsup` for building.
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build the project
+pnpm build
+
+# Run in development mode
+pnpm dev
+
+# Run tests
+pnpm test
+```
+
+---
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.
+
+1. Fork the Project
+2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
+3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
+4. Push to the Branch (`git push origin feature/AmazingFeature`)
+5. Open a Pull Request
+
+---
+
+## License
+
+Distributed under the MIT License. See `LICENSE` for more information.

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+
+export {  }