@orderful/droid 0.2.0

package/src/skills/comments/SKILL.yaml

@@ -0,0 +1,18 @@
+name: comments
+description: Inline conversation in any file via @droid/@user markers
+version: 0.1.0
+status: beta
+dependencies: []
+provides_output: false
+config_schema:
+  user_mention:
+    type: string
+    description: Override the global user mention for this skill
+  ai_mentions:
+    type: string
+    description: Additional AI mentions to recognize (comma-separated, e.g., "@claude,@ai")
+    default: ""
+  preserve_comments:
+    type: boolean
+    description: Keep original comments after addressing (vs removing them)
+    default: false

package/src/skills/comments/commands/comments.md

@@ -0,0 +1,48 @@
+# /comments - Check and respond to inline comments
+
+Check for `> @droid` comments (and configured aliases like `@claude`) in files and address them.
+
+## Usage
+
+```
+/comments              # Check all files in cwd
+/comments check        # Same as above
+/comments check {path} # Check specific file or directory
+/comments cleanup      # Remove resolved comment threads
+```
+
+## Arguments
+
+$ACTION - The action to perform: check (default) or cleanup
+$PATH - Optional path to scope the search
+
+## Behavior
+
+When you find a `> @droid` comment (or configured alias):
+
+1. **Read the context** - Understand what the comment is asking by reading surrounding code/text
+2. **Determine intent**:
+   - If it's an **action request** (e.g., "add error handling", "refactor this"):
+     - Execute the requested action
+     - Remove the comment (unless preserve_comments is true)
+   - If it's a **question** (e.g., "what do you think?", "is this approach good?"):
+     - Respond with `> @{user_mention}` on a new line below
+     - Keep the original comment for context
+3. **Check git diff first** - If there's uncommitted changes, prioritize checking those files
+
+## Response Format
+
+When responding to questions, use the configured user tag:
+
+```markdown
+> @droid Should we use async/await here?
+
+> @fry Yes, async/await would be cleaner here because...
+```
+
+## Configuration
+
+Check `~/.droid/skills/comments/overrides.yaml` for:
+- `user_mention` - Your @mention for responses
+- `ai_mentions` - Additional mentions to recognize (e.g., `@claude`)
+- `preserve_comments` - Keep or remove addressed comments

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "resolveJsonModule": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}