claude-auto-summary 1.0.0

package/README.md

@@ -0,0 +1,71 @@
+# claude-auto-summary
+
+Claude Code skill — automatically saves well-structured markdown summaries after web research and information-gathering tasks.
+
+## What It Does
+
+After you ask Claude Code to search for, find, compare, or gather information about tools, plugins, skills, frameworks, or any topic requiring multiple web searches, this skill makes Claude **automatically save** a structured `.md` summary file to your project — without you having to ask "save this as markdown."
+
+## Install
+
+```bash
+# One-shot (no global install needed)
+npx claude-auto-summary
+
+# Or install globally
+npm install -g claude-auto-summary
+auto-summary-skill
+```
+
+Skills are copied to `~/.claude/skills/` where Claude Code picks them up automatically.
+
+## What Gets Saved
+
+Every summary file includes:
+
+- **Date stamp** — when the research was done
+- **Categorized sections** — organized by theme/type
+- **Comparison tables** — scannable, actionable
+- **Source links** — every tool/claim has a URL
+- **Quick recommendations** — what to DO, not just what exists
+
+## Trigger Conditions
+
+The skill activates when:
+
+1. You ran 2+ web searches on the same topic
+2. You asked to find skills/plugins/tools for X
+3. You asked to compare options
+4. You gathered facts from multiple sources
+5. You explicitly asked to summarize
+
+## Usage
+
+### CLI
+
+```bash
+# List bundled skills
+auto-summary-skill --list
+
+# Preview what would be installed
+auto-summary-skill --dry-run
+
+# Install to ~/.claude/skills/
+auto-summary-skill
+```
+
+### Programmatic
+
+```javascript
+const skill = require('claude-auto-summary');
+
+console.log(skill.skills);
+// => ['auto-summary']
+
+const skillPath = skill.getSkillPath('auto-summary');
+// => '/path/to/skills/auto-summary'
+```
+
+## License
+
+MIT

package/bin/install.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const PACKAGE_NAME = 'claude-auto-summary';
+const SRC_DIR = path.join(__dirname, '..', 'skills');
+const HOME = process.env.HOME || process.env.USERPROFILE;
+const DEST_DIR = path.join(HOME, '.claude', 'skills');
+
+function printUsage() {
+  console.log(`
+  ${PACKAGE_NAME} — Install auto-summary skill to Claude Code
+
+  Usage:
+    auto-summary-skill              Install the skill
+    auto-summary-skill --list       List bundled skills
+    auto-summary-skill --dry-run    Show what would be installed
+    auto-summary-skill --help       Show this help message
+
+  Skills are installed to: ${DEST_DIR}
+`);
+}
+
+function listSkills() {
+  const meta = require('../index.js');
+  console.log(`\n  ${PACKAGE_NAME} v${meta.version}`);
+  console.log(`  ${meta.skillCount} bundled skill(s):\n`);
+  for (const skill of meta.skills) {
+    console.log(`    - ${skill}`);
+  }
+  console.log();
+}
+
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(src)) return 0;
+
+  fs.mkdirSync(dest, { recursive: true });
+  let count = 0;
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      count += copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      count++;
+    }
+  }
+  return count;
+}
+
+function install(dryRun) {
+  if (!fs.existsSync(SRC_DIR)) {
+    console.error('  Error: Skills source directory not found at', SRC_DIR);
+    process.exit(1);
+  }
+
+  const skillDirs = fs.readdirSync(SRC_DIR, { withFileTypes: true })
+    .filter(d => d.isDirectory())
+    .map(d => d.name);
+
+  if (skillDirs.length === 0) {
+    console.log('  No skill directories found to install.');
+    return;
+  }
+
+  console.log(`\n  Installing ${skillDirs.length} skill(s) to ${DEST_DIR}\n`);
+
+  if (dryRun) {
+    for (const dir of skillDirs) {
+      console.log(`  [dry-run] Would copy: ${dir}`);
+    }
+    console.log(`\n  Destination: ${DEST_DIR}`);
+    return;
+  }
+
+  fs.mkdirSync(DEST_DIR, { recursive: true });
+
+  let totalFiles = 0;
+  for (const dir of skillDirs) {
+    const src = path.join(SRC_DIR, dir);
+    const dest = path.join(DEST_DIR, dir);
+    const count = copyDirRecursive(src, dest);
+    totalFiles += count;
+    console.log(`  Installed: ${dir} (${count} files)`);
+  }
+
+  console.log(`\n  Done. ${totalFiles} file(s) installed to ${DEST_DIR}`);
+  console.log('  Restart Claude Code to activate skills.\n');
+}
+
+// --- CLI ---
+const args = process.argv.slice(2);
+
+if (args.includes('--help') || args.includes('-h')) {
+  printUsage();
+} else if (args.includes('--list') || args.includes('-l')) {
+  listSkills();
+} else if (args.includes('--dry-run')) {
+  install(true);
+} else {
+  install(false);
+}

package/index.js

@@ -0,0 +1,27 @@
+'use strict';
+
+const path = require('path');
+
+const BUNDLED_SKILLS = ['auto-summary'];
+
+module.exports = {
+  name: 'claude-auto-summary',
+  version: '1.0.0',
+  skillCount: BUNDLED_SKILLS.length,
+  skills: BUNDLED_SKILLS,
+  skillsDir: path.join(__dirname, 'skills'),
+
+  /**
+   * Returns the absolute path to a specific skill directory.
+   * @param {string} skillName
+   * @returns {string}
+   */
+  getSkillPath(skillName) {
+    if (!BUNDLED_SKILLS.includes(skillName)) {
+      throw new Error(
+        `Skill "${skillName}" not found. Available: ${BUNDLED_SKILLS.join(', ')}`
+      );
+    }
+    return path.join(__dirname, 'skills', skillName);
+  },
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "claude-auto-summary",
+  "version": "1.0.0",
+  "description": "Claude Code skill — automatically saves well-structured markdown summaries after web research and information-gathering tasks",
+  "main": "index.js",
+  "bin": {
+    "auto-summary-skill": "bin/install.js"
+  },
+  "files": [
+    "skills/",
+    "bin/",
+    "index.js",
+    "README.md"
+  ],
+  "scripts": {
+    "install-skills": "node bin/install.js",
+    "list": "node -e \"const s = require('./index.js'); console.log('Skills:', s.skills.join(', '));\""
+  },
+  "keywords": [
+    "claude-code",
+    "claude",
+    "skill",
+    "auto-summary",
+    "research",
+    "markdown",
+    "writing",
+    "documentation"
+  ],
+  "author": "trtr123",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}

package/skills/auto-summary/SKILL.md

@@ -0,0 +1,117 @@
+---
+name: auto-summary
+description: Research auto-summary skill — automatically saves well-structured markdown summaries after any substantial web research or information-gathering task. Triggers when the user asks you to search for, find, compare, or gather information about tools, plugins, skills, frameworks, methodologies, or any topic requiring multiple web searches to compile a comprehensive answer. Instead of only replying in-chat, you MUST also write the compiled findings as a well-organized .md file to the project root. This is a behavioral habit — you save first, then tell the user.
+---
+
+# Auto-Summary — Research → Markdown Workflow
+
+When you perform substantial research (web searches, multi-source information gathering, tool/plugin comparisons), you **automatically save** a structured markdown summary to the project root. Never wait for the user to ask "save this as md" — it is part of completing the research task.
+
+---
+
+## Trigger Conditions
+
+Save a summary file when ANY of these are true:
+
+1. **Multi-source research**: You ran 2+ web searches on the same topic
+2. **Tool/plugin discovery**: User asked "find skills/plugins/tools for X"
+3. **Comparison tasks**: User asked to compare options, find the best X for Y
+4. **Information compilation**: You gathered facts from multiple URLs or sources
+5. **User explicitly asks**: "summarize", "整理成文档", "保存为md", "记录下来"
+
+Do NOT trigger for: single-fact lookups, pure coding Q&A, trivial searches answered in one sentence.
+
+---
+
+## File Naming Convention
+
+```
+Claude-Code-{主题关键词}-{类型}.md
+```
+
+- Use Chinese for the topic keywords (matches user's language)
+- Keep under 40 characters total
+- Replace spaces with `-`
+- Examples:
+  - `Claude-Code-写作相关Skill汇总.md`
+  - `Claude-Code-现实主义小说插件汇总.md`
+
+---
+
+## Markdown Structure Template
+
+Every summary file MUST include these sections (order can adapt to content):
+
+```markdown
+# {Title}
+
+> 搜索日期：{YYYY-MM-DD}
+
+---
+
+## 一、{Category 1}
+
+### 1. [{Name}]({URL}) — {One-line tagline}
+
+| 维度 | 说明 |
+|------|------|
+| ... | ... |
+
+**{适配/应用场景}**：...
+
+---
+
+## 二、{Category 2}
+
+...
+
+---
+
+## {快速推荐 / 推荐组合}
+
+| 需求 | 推荐 | 理由 |
+|------|------|------|
+| ... | ... | ... |
+
+---
+
+## {关键提示 / 注意事项}
+
+1. ...
+2. ...
+```
+
+---
+
+## Quality Rules
+
+1. **Date stamp**: Always include the search date under the title
+2. **Source links**: Every tool/plugin MUST have a clickable URL to its source (GitHub, npm, etc.)
+3. **Comparison tables**: When presenting multiple options, use tables for scannability
+4. **Actionable recommendations**: End with "快速推荐" or "推荐组合" — the user should know what to DO
+5. **Concrete details**: Version numbers, command examples, install methods — not just descriptions
+6. **Chinese naming**: File names and section headers in Chinese if the user communicates in Chinese
+7. **Concise but complete**: Each tool gets one focused block, not paragraphs of narration
+
+---
+
+## Workflow
+
+```
+1. Complete research (web searches, source fetching)
+2. Compile findings in your response to the user
+3. IMMEDIATELY after (or in parallel with) responding, Write the .md file
+4. Confirm file path to user
+```
+
+The markdown file should be **self-contained** — someone reading it 3 months later should get full context without seeing the chat history.
+
+---
+
+## Anti-patterns
+
+- ❌ Replying with findings but not saving the file
+- ❌ Asking "should I save this?" — just do it
+- ❌ Saving raw search result dumps — curate and structure
+- ❌ Forgetting source URLs — every claim needs a link
+- ❌ Over-narrating in the file — tables > paragraphs