Files
daymade d9e1967689 feat(doc-to-markdown): CJK bold spacing, JSON pretty-print, 31 tests, full rename cleanup
- Add CJK bold spacing fix: insert spaces around **bold** spans containing
  CJK characters for correct rendering (handles emoji adjacency, already-spaced)
- Add JSON pretty-print: auto-format JSON code blocks with 2-space indent
- Add 31 unit tests covering all post-processing functions
- Fix pandoc simple table detection (1-space column gaps)
- Fix image path double-nesting when --assets-dir ends with 'media'
- Rename all markdown-tools references across 15 files (README, QUICKSTART,
  marketplace.json, CLAUDE.md, meeting-minutes-taker, GitHub templates)
- Add 5-tool benchmark report (Docling/MarkItDown/Pandoc/Mammoth/ours)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 03:18:37 +08:00

854 lines
43 KiB
Markdown

# 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).
## [Unreleased]
### Changed
- **Renamed**: `markdown-tools``doc-to-markdown` — clearer name for DOCX/PDF/PPTX → Markdown conversion
- **doc-to-markdown**: Added 8 DOCX post-processing fixes (grid tables, simple tables, CJK bold spacing, JSON pretty-print, image path flattening, pandoc attribute cleanup, code block detection, bracket fixes)
- **doc-to-markdown**: Added 31 unit tests (`test_convert.py`)
- **doc-to-markdown**: Added 5-tool benchmark report (`references/benchmark-2026-03-22.md`)
## [1.39.0] - 2026-03-18
### Added
- **New Skill**: scrapling-skill v1.0.0 - Reliable Scrapling CLI installation, troubleshooting, and extraction workflows for HTML, Markdown, and text output
- Bundled `diagnose_scrapling.py` script to verify CLI health, detect missing extras, inspect Playwright browser runtime, and run real smoke tests
- Static-first workflow for choosing between `extract get`, `extract fetch`, and `stealthy-fetch`
- Verified WeChat public article extraction pattern using `#js_content`
- Verified recovery path for local TLS trust-store failures via `--no-verify`
- Bundled troubleshooting reference covering extras, browser runtime, and output validation
### Changed
- **skill-creator** v1.5.0 → v1.5.1: Fixed `scripts/package_skill.py` so it works when invoked directly from the repository root instead of only via `python -m`
- **continue-claude-work** v1.1.0 → v1.1.1: Replaced newer Python-only type syntax in `extract_resume_context.py` so the script runs under the local `python3` environment
- Updated marketplace skills/plugins count from 42 to 43
- Updated marketplace version from 1.38.0 to 1.39.0
- Updated marketplace metadata description to include Scrapling CLI extraction workflows
- Updated README.md and README.zh-CN.md badges, installation commands, skill listings, use cases, quick links, and requirements
- Updated CLAUDE.md counts, version reference, and Available Skills list (added #43)
## [1.38.0] - 2026-03-07
### Added
- **New Skill**: continue-claude-work v1.1.0 - Recover local `.claude` session context and continue interrupted work without `claude --resume`
- Bundled Python script (`extract_resume_context.py`) for one-call context extraction
- Compact-boundary-aware extraction using `isCompactSummary` flag (highest-signal context from session compaction summaries)
- Subagent workflow recovery — parses `subagents/` directory to report completed vs interrupted agents with last outputs
- Session end reason detection — classifies clean exit, interrupted (ctrl-c), error cascade, or abandoned
- Size-adaptive reading strategy based on file size and compaction count
- Noise filtering — skips progress/queue-operation/api_error (37-53% of session lines)
- Self-session exclusion, stale index fallback, ghost session warnings
- MEMORY.md and session-memory integration, git workspace state fusion
### Changed
- **skill-creator** v1.4.1 → v1.5.0: SKILL.md rewrite, added eval benchmarking system (run_eval, run_loop, aggregate_benchmark), agents (analyzer, comparator, grader), eval-viewer, and improve_description script
- **transcript-fixer** v1.1.0 → v1.2.0: `--domain` defaults to all domains, added `get_domain_stats()`, cross-domain listing, and zero-match hints
- **tunnel-doctor** v1.3.0 → v1.4.0: Added Step 2C-1 for local vanity domain proxy interception, bundled `quick_diagnose.py` automated diagnostic script
- **pdf-creator** v1.0.0 → v1.1.0: Replaced Python `markdown` library with pandoc for MD→HTML conversion, removed `_ensure_list_spacing` workaround
- **github-contributor** v1.0.2 → v1.0.3: Fixed gh CLI field name (`stargazersCount``stargazerCount`), added Prerequisites section
- Updated marketplace skills/plugins count from 41 to 42
- Updated marketplace version from 1.37.0 to 1.38.0
- Updated README.md and README.zh-CN.md badges, installation commands, skill listings, use cases, quick links, and requirements
- Updated CLAUDE.md counts, version reference, and Available Skills list (added #42)
## [1.37.0] - 2026-03-02
### Added
- **New Skill**: excel-automation - Create formatted Excel files, parse complex xlsm models, and control Excel on macOS
- Bundled scripts for workbook generation and complex XML/ZIP parsing
- Bundled reference: formatting-reference.md for styles, number formats, and layout patterns
- AppleScript control patterns with timeout-safe execution guidance
- **New Skill**: capture-screen - Programmatic macOS screenshot capture workflows
- Bundled Swift script for CGWindowID discovery
- AppleScript + screencapture multi-shot workflow patterns
- Clear anti-pattern guidance for unreliable window ID methods
- Added missing `promptfoo-evaluation/scripts/metrics.py` referenced by skill examples
### Changed
- Updated marketplace skills/plugins count from 39 to 41
- Updated marketplace version from 1.36.0 to 1.37.0
- Bumped `promptfoo-evaluation` plugin version from 1.0.0 to 1.1.0 (skill content update + missing script fix)
- Updated README.md and README.zh-CN.md badges, installation commands, skill listings, use cases, quick links, and requirements
- Updated CLAUDE.md counts, version reference, and Available Skills list (added #40 and #41)
## [1.36.0] - 2026-03-02
### Added
- **New Skill**: financial-data-collector - Collect real financial data for US public companies via yfinance
- Structured JSON output with market data, income statement, cash flow, balance sheet, WACC inputs, analyst estimates
- Validation script with 9 checks (field completeness, cross-field consistency, sign conventions, NaN detection)
- Reference docs: output-schema.md, yfinance-pitfalls.md (NaN years, field aliases, FCF definition mismatch)
- NO FALLBACK principle: null for missing data, never default values
### Changed
- Updated marketplace skills count from 38 to 39
- Updated marketplace version from 1.35.0 to 1.36.0
- Updated README.md and README.zh-CN.md badges (skills count, version)
- Updated CLAUDE.md skills count and list
## [1.34.1] - 2026-02-23
### Changed
- Bumped marketplace metadata version from 1.34.0 to 1.34.1 in `.claude-plugin/marketplace.json`
- Added product-analysis entries to `README.md` and `README.zh-CN.md` and aligned skills count / version badges to 38 / 1.34.1
- Added product-analysis quick links in both READMEs and added use-case section in both READMEs
- Added **product-analysis** to `CLAUDE.md` and updated CLAUDE skill counts / version references to 38 and v1.34.1
- Bumped `skills-search` plugin version in `marketplace.json` from 1.0.0 to 1.1.0
- Bumped updated skill versions in `marketplace.json` after documentation updates:
- `skill-creator`: 1.4.0 -> 1.4.1
- `iOS-APP-developer`: 1.1.0 -> 1.1.1
- `macos-cleaner`: 1.1.0 -> 1.1.1
- `competitors-analysis`: 1.0.0 -> 1.0.1
- `tunnel-doctor`: 1.2.0 -> 1.2.1
- `product-analysis`: 1.0.0 -> 1.0.1
## [1.33.1] - 2026-02-17
### Changed
- **tunnel-doctor** v1.1.0 → v1.2.0: Add Layer 4 SSH ProxyCommand double tunnel diagnostics
- New conflict layer: SSH ProxyCommand double tunneling causing intermittent git push/pull failures
- New diagnostic step 2F: detect and fix redundant HTTP CONNECT tunnel when Shadowrocket TUN is active
- Structural improvements per skill best practices:
- Eliminate content duplication between SKILL.md and reference (73 → 27 lines)
- Rename `proxy_fixes.md``proxy_conflict_reference.md` for clarity
- Trim SKILL.md to 487 lines (under 500 limit)
- Fix "apply all four" listing 5 items (separate anti-pattern warning)
- Clarify Layer 4's relationship to Tailscale theme
## [1.33.0] - 2026-02-16
### Changed
- **tunnel-doctor** v1.0.0 → v1.1.0: Added remote development SOP with SSH tunnel and Makefile patterns
- New SOP section: proxy-safe Makefile pattern (`--noproxy localhost` for all health checks)
- New SOP section: SSH tunnel Makefile targets (`tunnel`/`tunnel-bg` with autossh)
- New SOP section: multi-port tunnel configuration
- New SOP section: SSH non-login shell setup (deduped, references proxy_fixes.md)
- New SOP section: end-to-end workflow (first-time setup + daily workflow)
- New SOP section: pre-flight checklist (10 verification items)
- New diagnostic step 2D: auth redirect fix via SSH local port forwarding
- New diagnostic step 2E: localhost proxy interception in Makefiles/scripts
- Fixed step ordering: 2A→2B→2C→2D→2E (was 2A→2C→2D→2E→2B)
- Fixed description to third-person voice per skill best practices
- Replaced hardcoded IP with `<tailscale-ip>` placeholder (5 occurrences)
- Added SSH non-login shell pitfall to references/proxy_fixes.md
- Added localhost proxy interception section to references/proxy_fixes.md
- Strengthened `--data-binary` vs `-d` warning in references/proxy_fixes.md
- New keywords: ssh-tunnel, autossh, makefile, remote-development
- Updated marketplace version from 1.32.1 to 1.33.0
## [1.32.0] - 2026-02-09
### Added
- **New Skill**: windows-remote-desktop-connection-doctor - Diagnose AVD/W365 connection quality issues
- 5-step diagnostic workflow for transport protocol analysis
- UDP Shortpath vs WebSocket detection and root cause identification
- VPN/proxy interference detection (ShadowRocket, Clash, Tailscale)
- Windows App log parsing for STUN/TURN/ICE negotiation failures
- ISP UDP restriction testing and Chinese ISP-specific guidance
- Bundled references: windows_app_log_analysis.md, avd_transport_protocols.md
### Changed
- Updated marketplace skills count from 36 to 37
- Updated marketplace version from 1.31.0 to 1.32.0
- Updated README.md badges (skills count, version)
- Updated README.md to include windows-remote-desktop-connection-doctor in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include windows-remote-desktop-connection-doctor in skills listing
- Updated CLAUDE.md skills count from 36 to 37
## [1.31.0] - 2026-02-07
### Added
- **New Skill**: tunnel-doctor - Diagnose and fix Tailscale + proxy/VPN route conflicts
- 6-step diagnostic workflow for route conflict detection and resolution
- Shadowrocket, Clash, Surge proxy tool fix guides
- Tailscale SSH ACL configuration (check vs accept)
- WSL snap vs apt Tailscale installation guidance
- Bundled references: proxy_fixes.md with per-tool instructions
- Shadowrocket config API documentation
### Changed
- Updated marketplace skills count from 35 to 36
- Updated marketplace version from 1.30.0 to 1.31.0
- Updated README.md badges (skills count, version)
- Updated README.md to include tunnel-doctor in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include tunnel-doctor in skills listing
- Updated CLAUDE.md skills count from 35 to 36
## [1.30.0] - 2026-01-29
### Added
- **New Skill**: competitors-analysis - Evidence-based competitor tracking and analysis
- Pre-analysis checklist to ensure repositories are cloned locally
- Forbidden patterns to prevent assumptions and speculation
- Required patterns for source citation (file:line_number)
- Tech stack analysis guides for Node.js, Python, Rust projects
- Directory structure conventions for competitor tracking
- Bundled references: profile_template.md, analysis_checklist.md
- Management script: update-competitors.sh (clone/pull/status)
### Changed
- Updated marketplace skills count from 34 to 35
- Updated marketplace version from 1.29.0 to 1.30.0
- Updated README.md badges (skills count, version)
- Updated README.md to include competitors-analysis in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include competitors-analysis in skills listing
- Updated CLAUDE.md skills count from 34 to 35
- Added competitors-analysis use case section to README.md
- Added competitors-analysis use case section to README.zh-CN.md
## [1.29.0] - 2026-01-29
### Added
- **Enhanced Skill**: skill-creator v1.4.0 - Comprehensive YAML frontmatter documentation
- Complete YAML frontmatter reference table with all available fields
- `context: fork` documentation - critical for subagent-accessible skills
- Invocation control comparison table showing behavior differences
- `$ARGUMENTS` placeholder explanation with usage examples
- `allowed-tools` wildcard syntax examples (`Bash(git *)`, `Bash(npm *)`, `Bash(docker compose *)`)
- `hooks` field inline example for pre-invoke configuration
- Updated init_skill.py template with commented optional fields
### Changed
- Updated marketplace version from 1.28.0 to 1.29.0
- Updated skill-creator plugin version from 1.3.0 to 1.4.0
### Contributors
- [@costa-marcello](https://github.com/costa-marcello) - PR #6: Initial frontmatter documentation
## [1.28.0] - 2026-01-25
### Added
- **Enhanced Skill**: meeting-minutes-taker v1.1.0 - Speaker identification and pre-processing pipeline
- Speaker identification via feature analysis (word count, segment count, filler ratio, speaking style)
- Context file template (`references/context_file_template.md`) for team directory mapping
- Intelligent file naming pattern: `YYYY-MM-DD-<topic>-<type>.md`
- Pre-processing pipeline integration with markdown-tools and transcript-fixer
- Transcript quality assessment workflow
### Changed
- Updated marketplace version from 1.27.0 to 1.28.0
- Updated meeting-minutes-taker plugin version from 1.0.0 to 1.1.0
## [1.27.0] - 2026-01-25
### Added
- **Enhanced Skill**: markdown-tools v1.2.0 - Multi-tool orchestration with Heavy Mode
- Dual mode architecture: Quick Mode (fast) and Heavy Mode (best quality)
- New `convert.py` - Main orchestrator with tool selection matrix
- New `merge_outputs.py` - Segment-level multi-tool output merger
- New `validate_output.py` - Quality validation with HTML reports
- Enhanced `extract_pdf_images.py` - Image extraction with metadata (page, position, dimensions)
- PyMuPDF4LLM integration for LLM-optimized PDF conversion
- pandoc integration for DOCX/PPTX structure preservation
- Quality metrics: text retention, table retention, image retention
- New references: heavy-mode-guide.md, tool-comparison.md
### Changed
- Updated marketplace version from 1.26.0 to 1.27.0
- Updated markdown-tools plugin version from 1.1.0 to 1.2.0
## [1.26.0] - 2026-01-25
### Added
- **New Skill**: deep-research - Format-controlled research reports with evidence mapping
- Report spec and format contract workflow
- Multi-pass parallel drafting with UNION merge
- Evidence table with source quality rubric
- Citation verification and conflict handling
- Bundled references: report template, formatting rules, research plan checklist, source quality rubric, completeness checklist
### Changed
- Updated marketplace skills count from 33 to 34
- Updated marketplace version from 1.25.0 to 1.26.0
- Updated README.md badges (skills count, version)
- Updated README.md to include deep-research in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include deep-research in skills listing
- Updated CLAUDE.md skills count from 33 to 34
- Added deep-research use case section to README.md
- Added deep-research use case section to README.zh-CN.md
- Added deep-research documentation quick link to README.md
- Added deep-research documentation quick link to README.zh-CN.md
## [1.25.0] - 2026-01-24
### Added
- **New Skill**: meeting-minutes-taker - Transform meeting transcripts into structured minutes
- Multi-pass parallel generation with UNION merge strategy
- Evidence-based recording with speaker quotes
- Mermaid diagrams for architecture discussions
- Iterative human-in-the-loop refinement workflow
- Bundled references: template and completeness checklist
### Changed
- Updated marketplace skills count from 32 to 33
- Updated marketplace version from 1.24.0 to 1.25.0
- Updated skill-creator to v1.3.0:
- Added Step 5: Sanitization Review (Optional)
- New references/sanitization_checklist.md with 8 categories of content to sanitize
- Automated grep scan commands for detecting sensitive content
- 3-phase sanitization process and completion checklist
## [1.24.0] - 2026-01-22
### Added
- **New Skill**: claude-skills-troubleshooting - Diagnose and resolve Claude Code plugin and skill configuration issues
- Plugin installation and enablement debugging
- installed_plugins.json vs settings.json enabledPlugins diagnosis
- Marketplace cache freshness detection
- Plugin state architecture documentation
- Bundled diagnostic script (diagnose_plugins.py)
- Batch enable script for missing plugins (enable_all_plugins.py)
- Known GitHub issues tracking (#17832, #19696, #17089, #13543, #16260)
- Skills vs Commands architecture explanation
### Changed
- Updated marketplace skills count from 31 to 32
- Updated marketplace version from 1.23.0 to 1.24.0
- Updated README.md badges (skills count, version)
- Updated README.md to include claude-skills-troubleshooting in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include claude-skills-troubleshooting in skills listing
- Updated CLAUDE.md skills count from 31 to 32
- Added claude-skills-troubleshooting use case section to README.md
- Added claude-skills-troubleshooting use case section to README.zh-CN.md
## [1.23.0] - 2026-01-22
### Added
- **New Skill**: i18n-expert - Complete internationalization/localization setup and auditing for UI codebases
- Library selection and setup (react-i18next, next-intl, vue-i18n)
- Key architecture and locale file organization (JSON, YAML, PO, XLIFF)
- Translation generation strategy (AI, professional, manual)
- Routing and language detection/switching
- SEO and metadata localization
- RTL support for applicable locales
- Key parity validation between en-US and zh-CN
- Pluralization and formatting validation
- Error code mapping to localized messages
- Bundled i18n_audit.py script for key usage extraction
- Scope inputs: framework, existing i18n state, target locales, translation quality needs
### Changed
- Updated marketplace skills count from 30 to 31
- Updated marketplace version from 1.22.0 to 1.23.0
- Updated README.md badges (skills count, version)
- Updated README.md to include i18n-expert in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include i18n-expert in skills listing
- Updated CLAUDE.md skills count from 30 to 31
- Added i18n-expert use case section to README.md
- Added i18n-expert use case section to README.zh-CN.md
### Changed
- None
### Deprecated
- None
### Removed
- None
### Fixed
- None
### Security
- None
## [1.22.0] - 2026-01-15
### Added
- **New Skill**: skill-reviewer - Reviews and improves Claude Code skills against official best practices
- Self-review mode: Validate your own skills before publishing
- External review mode: Evaluate others' skill repositories
- Auto-PR mode: Fork, improve, and submit PRs to external repos
- Automated validation via bundled skill-creator scripts
- Evaluation checklist covering frontmatter, instructions, and resources
- Additive-only contribution principle (never delete files)
- PR guidelines with tone recommendations and templates
- Self-review checklist for respect verification
- References: evaluation_checklist.md, pr_template.md, marketplace_template.json
- Auto-install dependencies: automatically installs skill-creator if missing
- **New Skill**: github-contributor - Strategic guide for becoming an effective GitHub contributor
- Four contribution types: Documentation, Code Quality, Bug Fixes, Features
- Project selection criteria with red flags
- PR excellence workflow with templates
- Reputation building ladder (Documentation → Bug Fixes → Features → Maintainer)
- GitHub CLI command reference
- Conventional commit message format
- Common mistakes and best practices
- References: pr_checklist.md, project_evaluation.md, communication_templates.md
### Changed
- Updated marketplace skills count from 28 to 30
- Updated marketplace version from 1.21.1 to 1.22.0
- Updated README.md badges (skills count: 30, version: 1.22.0)
- Updated README.md to include skill-reviewer in skills listing
- Updated README.md to include github-contributor in skills listing
- Updated README.zh-CN.md badges (skills count: 30, version: 1.22.0)
- Updated README.zh-CN.md to include skill-reviewer in skills listing
- Updated README.zh-CN.md to include github-contributor in skills listing
- Updated CLAUDE.md skills count from 28 to 30
- Added skill-reviewer use case section to README.md
- Added github-contributor use case section to README.md
- Added skill-reviewer use case section to README.zh-CN.md
- Added github-contributor use case section to README.zh-CN.md
## [1.21.1] - 2026-01-11
### Changed
- **Updated Skill**: macos-cleaner v1.0.0 → v1.1.0 - Major improvements based on real-world usage
- Added "Value Over Vanity" principle: Goal is identifying truly useless items, not maximizing cleanup numbers
- Added "Network Environment Awareness": Consider slow internet (especially in China) when recommending cache deletion
- Added "Impact Analysis Required": Every cleanup recommendation must explain consequences
- Added comprehensive "Anti-Patterns" section: What NOT to delete (Xcode DerivedData, npm _cacache, uv cache, Playwright, iOS DeviceSupport, etc.)
- Added "Multi-Layer Deep Exploration" guide: Complete tmux + Mole TUI navigation workflow
- Added "High-Quality Report Template": Proven 3-tier classification report format (🟢/🟡/🔴)
- Added "Report Quality Checklist": 8-point verification before presenting findings
- Added explicit prohibition of `docker volume prune -f` - must confirm per-project
- Updated safety principles to emphasize cache value over cleanup metrics
## [1.21.0] - 2026-01-11
### Added
- **New Skill**: macos-cleaner - Intelligent macOS disk space analysis and cleanup with safety-first philosophy
- Smart analysis of system caches, application caches, logs, and temporary files
- Application remnant detection (orphaned data from uninstalled apps)
- Large file discovery with automatic categorization (videos, archives, databases, disk images)
- Development environment cleanup (Docker, Homebrew, npm, pip, Git repositories)
- Interactive safe deletion with user confirmation at every step
- Risk-level categorization (🟢 Safe / 🟡 Caution / 🔴 Keep)
- Integration guide for Mole visual cleanup tool
- Before/after cleanup reports with space recovery metrics
- Bundled scripts: `analyze_caches.py`, `analyze_dev_env.py`, `analyze_large_files.py`, `find_app_remnants.py`, `safe_delete.py`, `cleanup_report.py`
- Comprehensive safety rules and cleanup target documentation
- Time Machine backup recommendations for large deletions
- Professional user experience: analyze first, explain thoroughly, execute with confirmation
### Changed
- Updated marketplace skills count from 27 to 28
- Updated marketplace version from 1.20.0 to 1.21.0
- Updated README.md badges (skills count: 28, version: 1.21.0)
- Updated README.md to include macos-cleaner in skills listing
- Updated README.zh-CN.md badges (skills count: 28, version: 1.21.0)
- Updated README.zh-CN.md to include macos-cleaner in skills listing
- Updated CLAUDE.md skills count from 27 to 28
- Added macos-cleaner use case section to README.md
- Added macos-cleaner use case section to README.zh-CN.md
## [1.20.0] - 2026-01-11
### Added
- **New Skill**: twitter-reader - Fetch Twitter/X post content using Jina.ai API
- Bypass JavaScript restrictions without authentication
- Retrieve tweet content including author, timestamp, post text, images, and thread replies
- Support for individual posts or batch fetching from x.com or twitter.com URLs
- Bundled scripts: `fetch_tweet.py` (Python) and `fetch_tweets.sh` (Bash)
- Environment variable configuration for secure API key management
- Supports both x.com and twitter.com URL formats
### Changed
- Updated marketplace skills count from 26 to 27
- Updated marketplace version from 1.19.0 to 1.20.0
- Updated README.md badges (skills count: 27, version: 1.20.0)
- Updated README.md to include twitter-reader in skills listing
- Updated README.zh-CN.md badges (skills count: 27, version: 1.20.0)
- Updated README.zh-CN.md to include twitter-reader in skills listing
- Updated CLAUDE.md skills count from 26 to 27
- Added twitter-reader use case section to README.md
- Added twitter-reader use case section to README.zh-CN.md
### Security
- **twitter-reader**: Implemented secure API key management using environment variables
- Removed hardcoded API keys from all scripts and documentation
- Added validation for JINA_API_KEY environment variable
- Enforced HTTPS-only URLs in Python script
## [1.18.2] - 2026-01-05
### Changed
- **claude-md-progressive-disclosurer**: Enhanced workflow with safety and verification features
- Added mandatory backup step (Step 0) before any modifications
- Added pre-execution verification checklist (Step 3.5) to prevent information loss
- Added post-optimization testing (Step 5) for discoverability validation
- Added exception criteria for size guidelines (safety-critical, high-frequency, security-sensitive)
- Added project-level vs user-level CLAUDE.md guidance
- Updated references/progressive_disclosure_principles.md with verification methods
- Updated claude-md-progressive-disclosurer plugin version from 1.0.0 to 1.0.1
## [1.18.1] - 2025-12-28
### Changed
- **markdown-tools**: Enhanced with PDF image extraction capability
- Added `extract_pdf_images.py` script using PyMuPDF
- Refactored SKILL.md for clearer workflow documentation
- Updated installation instructions to use `markitdown[pdf]` extra
- Updated marketplace version from 1.18.0 to 1.18.1
## [1.18.0] - 2025-12-20
### Added
- **New Skill**: pdf-creator - Convert markdown to PDF with Chinese font support (WeasyPrint)
- **New Skill**: claude-md-progressive-disclosurer - Optimize CLAUDE.md with progressive disclosure
- **New Skill**: promptfoo-evaluation - Promptfoo-based LLM evaluation workflows
- **New Skill**: iOS-APP-developer - iOS app development with XcodeGen, SwiftUI, and SPM
### Changed
- Updated marketplace skills count from 23 to 25
- Updated marketplace version from 1.16.0 to 1.18.0
- Updated README/README.zh-CN badges, skill lists, use cases, quick links, and requirements
- Updated QUICKSTART docs to clarify marketplace install syntax and remove obsolete links
- Updated CLAUDE.md skill counts and added the new skills to the list
## [1.16.0] - 2025-12-11
### Added
- **New Skill**: skills-search - CCPM registry search and management
- Search for Claude Code skills in the CCPM registry
- Install skills by name with `ccpm install <skill-name>`
- List installed skills with `ccpm list`
- Get detailed skill information with `ccpm info <skill-name>`
- Uninstall skills with `ccpm uninstall <skill-name>`
- Install skill bundles (web-dev, content-creation, developer-tools)
- Supports multiple installation formats (registry, GitHub owner/repo, full URLs)
- Troubleshooting guidance for common issues
### Changed
- Updated marketplace skills count from 22 to 23
- Updated marketplace version from 1.15.0 to 1.16.0
- Updated README.md badges (skills count: 23, version: 1.16.0)
- Updated README.md to include skills-search in skills listing (skill #20)
- Updated README.zh-CN.md badges (skills count: 23, version: 1.16.0)
- Updated README.zh-CN.md to include skills-search with Chinese translation
- Updated CLAUDE.md skills count from 22 to 23
- Added skills-search use case section to README.md
- Added skills-search use case section to README.zh-CN.md
- Added installation command for skills-search
- Enhanced marketplace metadata description to include CCPM skill management
## [1.13.0] - 2025-12-09
### Added
- **New Skill**: claude-code-history-files-finder - Session history recovery for Claude Code
- Search sessions by keywords with frequency ranking
- Recover deleted files from Write tool calls with automatic deduplication
- Analyze session statistics (message counts, tool usage, file operations)
- Batch operations for processing multiple sessions
- Streaming processing for large session files (>100MB)
- Bundled scripts: analyze_sessions.py, recover_content.py
- Bundled references: session_file_format.md, workflow_examples.md
- Follows Anthropic skill authoring best practices (third-person description, imperative style, progressive disclosure)
- **New Skill**: docs-cleaner - Documentation consolidation
- Consolidate redundant documentation while preserving valuable content
- Redundancy detection for overlapping documents
- Smart merging with structure preservation
- Validation for consolidated documents
### Changed
- Updated marketplace skills count from 18 to 20
- Updated marketplace version from 1.11.0 to 1.13.0
- Updated README.md badges (skills count: 20, version: 1.13.0)
- Updated README.md to include claude-code-history-files-finder in skills listing (skill 18)
- Updated README.md to include docs-cleaner in skills listing (skill 19)
- Updated README.zh-CN.md badges (skills count: 20, version: 1.13.0)
- Updated README.zh-CN.md to include both new skills with Chinese translations
- Updated CLAUDE.md skills count from 18 to 20
- Added session history recovery use case section to README.md
- Added documentation maintenance use case section to README.md
- Added corresponding use case sections to README.zh-CN.md
- Added installation commands for both new skills
- Added quick links for documentation references
- **skill-creator** v1.2.0 → v1.2.1: Added cache directory warning
- Added critical warning about not editing skills in `~/.claude/plugins/cache/`
- Explains that cache is read-only and changes are lost on refresh
- Provides correct vs wrong path examples
- **transcript-fixer** v1.0.0 → v1.1.0: Enhanced with Chinese domain support and AI fallback
- Added Chinese/Japanese/Korean character support for domain names (e.g., `火星加速器`, `具身智能`)
- Added `[CLAUDE_FALLBACK]` signal when GLM API is unavailable for Claude Code to take over
- Added Prerequisites section requiring `uv` for Python execution
- Added Critical Workflow section for dictionary iteration best practices
- Added AI Fallback Strategy section with manual correction guidance
- Added Database Operations section with schema reference requirement
- Added Stages table for quick reference (Dictionary → AI → Full pipeline)
- Added new bundled script: `ensure_deps.py` for shared virtual environment
- Added new bundled references: `database_schema.md`, `iteration_workflow.md`
- Updated domain validation from whitelist to pattern matching
- Updated tests for Chinese domain names and security bypass attempts
## [youtube-downloader-1.1.0] - 2025-11-19
### Changed
- **youtube-downloader** v1.0.0 → v1.1.0: Enhanced with HLS streaming support
- Added comprehensive HLS stream download support (m3u8 format)
- Added support for platforms like Mux, Vimeo, and other HLS-based services
- Added ffmpeg-based download workflow with authentication headers
- Added Referer header configuration for protected streams
- Added protocol whitelisting guidance
- Added separate audio/video stream handling and merging workflow
- Added troubleshooting for 403 Forbidden errors
- Added troubleshooting for yt-dlp stuck on cookie extraction
- Added troubleshooting for expired signatures
- Added performance tips (10-15x realtime speed)
- Updated skill description to include HLS streams and authentication
- Updated "When to Use" triggers to include m3u8/HLS downloads
- Updated Overview to mention multiple streaming platforms
## [1.11.0] - 2025-11-16
### Added
- **New Skill**: prompt-optimizer - Transform vague prompts into precise EARS specifications
- EARS (Easy Approach to Requirements Syntax) transformation methodology
- 6-step optimization workflow: analyze, transform, identify theories, extract examples, enhance, present
- 5 EARS sentence patterns (ubiquitous, event-driven, state-driven, conditional, unwanted behavior)
- Domain theory grounding with 10+ categories (productivity, UX, gamification, learning, e-commerce, security)
- 40+ industry frameworks mapped to use cases (GTD, BJ Fogg, Gestalt, AIDA, Zero Trust, etc.)
- Role/Skills/Workflows/Examples/Formats prompt enhancement framework
- Advanced optimization techniques (multi-stakeholder, non-functional requirements, complex logic)
- Bundled references: ears_syntax.md, domain_theories.md, examples.md
- Complete transformation examples (procrastination app, e-commerce, learning platform, password reset)
- Progressive disclosure pattern (metadata → SKILL.md → bundled resources)
### Changed
- Updated marketplace skills count from 17 to 18
- Updated marketplace version from 1.10.0 to 1.11.0
- Updated README.md badges (skills count, version)
- Updated README.md to include prompt-optimizer in skills listing
- Updated README.zh-CN.md badges (skills count, version)
- Updated README.zh-CN.md to include prompt-optimizer in skills listing
- Updated CLAUDE.md skills count from 17 to 18
- Added prompt-optimizer use case section to README.md
- Added prompt-optimizer use case section to README.zh-CN.md
- Enhanced marketplace metadata description to include prompt optimization capability
- **prompt-optimizer v1.1.0**: Improved skill following Anthropic best practices
- Reduced SKILL.md from 369 to 195 lines (47% reduction) using progressive disclosure
- Added new reference: advanced_techniques.md (325 lines) for multi-stakeholder, non-functional, and complex logic patterns
- Added 4th complete example (password reset security) to examples.md
- Added attribution to 阿星AI工作室 (A-Xing AI Studio) for EARS methodology inspiration
- Enhanced reference loading guidance with specific triggers for each file
- Improved conciseness and clarity following skill authoring best practices
## [1.10.0] - 2025-11-10
### Added
- **New Skill**: qa-expert - Comprehensive QA testing infrastructure with autonomous LLM execution
- One-command QA project initialization with complete templates and tracking CSVs
- Google Testing Standards implementation (AAA pattern, 90% coverage targets)
- Autonomous LLM-driven test execution via master prompts (100x speed improvement)
- OWASP Top 10 security testing framework (90% coverage target)
- Bug tracking with P0-P4 severity classification
- Quality gates enforcement (100% execution, ≥80% pass rate, 0 P0 bugs, ≥80% code coverage)
- Ground Truth Principle for preventing doc/CSV sync issues
- Day 1 onboarding guide for new QA engineers (5-hour timeline)
- Bundled scripts: `init_qa_project.py`, `calculate_metrics.py`
- Bundled references: master_qa_prompt.md, google_testing_standards.md, day1_onboarding.md, ground_truth_principle.md, llm_prompts_library.md
- Complete test case and bug tracking templates
- 30+ ready-to-use LLM prompts for QA tasks
- Progressive disclosure pattern (metadata → SKILL.md → bundled resources)
### Changed
- Updated marketplace skills count from 16 to 17
- Updated marketplace version from 1.9.0 to 1.10.0
- Updated README.md badges (skills count, version)
- Updated README.md to include qa-expert in skills listing
- Updated CLAUDE.md skills count from 16 to 17
- Added qa-expert use case section to README.md
- Enhanced marketplace metadata description to include QA testing capability
## [1.9.0] - 2025-10-29
### Added
- **New Skill**: video-comparer - Video comparison and quality analysis tool
- Compare original and compressed videos with interactive HTML reports
- Calculate quality metrics (PSNR, SSIM) for compression analysis
- Generate frame-by-frame visual comparisons with three viewing modes (slider, side-by-side, grid)
- Extract video metadata (codec, resolution, bitrate, duration, file size)
- Multi-platform FFmpeg installation instructions (macOS, Linux, Windows)
- Bundled Python script: `compare.py` with security features (path validation, resource limits)
- Comprehensive reference documentation (video metrics interpretation, FFmpeg commands, configuration)
- Self-contained HTML output with embedded frames (no server required)
### Changed
- Updated marketplace skills count from 15 to 16
- Updated marketplace version from 1.8.0 to 1.9.0
- Updated README.md badges (skills count, version)
- Updated README.md to include video-comparer in skills listing
- Updated CLAUDE.md skills count from 15 to 16
- Added video-comparer use case section to README.md
- Added FFmpeg to requirements section
## [1.6.0] - 2025-10-26
### Added
- **New Skill**: youtube-downloader - YouTube video and audio downloading with yt-dlp
- Download YouTube videos and playlists with robust error handling
- Audio-only download with MP3 conversion
- Android client workaround for nsig extraction issues (automatic)
- Format listing and custom format selection
- Network error handling for proxy/restricted environments
- Bundled Python script: `download_video.py` with yt-dlp availability check
- Comprehensive troubleshooting documentation for common yt-dlp issues
- Demo tape file and GIF showing download workflow
### Changed
- Updated marketplace.json from 12 to 13 skills
- Updated marketplace version from 1.5.0 to 1.6.0
- Enhanced marketplace metadata description to include YouTube downloading capability
- Updated CLAUDE.md with complete 13-skill listing
- Updated CLAUDE.md marketplace version to v1.6.0
- Updated README.md to reflect 13 available skills
- Updated README.md badges (skills count, version)
- Added youtube-downloader to manual installation instructions
- Added youtube-downloader use case section in README
- Added youtube-downloader to documentation quick links
- Added yt-dlp to requirements section
## [1.5.0] - 2025-10-26
### Added
- **New Skill**: ppt-creator - Professional presentation creation with dual-path PPTX generation
- Pyramid Principle structure (conclusion → reasons → evidence)
- Assertion-evidence slide framework
- Automatic data synthesis and chart generation (matplotlib)
- Dual-path PPTX creation (Marp CLI + document-skills:pptx)
- Complete orchestration: content → data → charts → PPTX with charts
- 45-60 second speaker notes per slide
- Quality scoring with auto-refinement (target: 75/100)
### Changed
- Updated marketplace.json from 11 to 12 skills
- Updated marketplace version from 1.4.0 to 1.5.0
## [1.4.0] - 2025-10-25
### Added
- **New Skill**: cloudflare-troubleshooting - API-driven Cloudflare diagnostics and troubleshooting
- Systematic investigation of SSL errors, DNS issues, and redirect loops
- Direct Cloudflare API integration for evidence-based troubleshooting
- Bundled Python scripts: `check_cloudflare_config.py` and `fix_ssl_mode.py`
- Comprehensive reference documentation (SSL modes, API overview, common issues)
- **New Skill**: ui-designer - Design system extraction from UI mockups and screenshots
- Automated design system extraction (colors, typography, spacing)
- Design system documentation generation
- PRD and implementation prompt creation
- Bundled templates: design-system.md, vibe-design-template.md, app-overview-generator.md
- Enhanced `.gitignore` patterns for archives, build artifacts, and documentation files
### Changed
- Updated marketplace.json from 9 to 11 skills
- Updated marketplace version from 1.3.0 to 1.4.0
- Enhanced marketplace metadata description to include new capabilities
- Updated CLAUDE.md with complete 11-skill listing
- Updated README.md to reflect 11 available skills
- Updated README.zh-CN.md to reflect 11 available skills
## [1.3.0] - 2025-10-23
### Added
- **New Skill**: cli-demo-generator - Professional CLI demo generation with VHS automation
- Automated demo generation from command lists
- Batch processing with YAML/JSON configs
- Interactive recording with asciinema
- Smart timing and multiple output formats
- Comprehensive improvement plan with 5 implementation phases
- Automated installation scripts for macOS/Linux (`install.sh`) and Windows (`install.ps1`)
- Complete Chinese translation (README.zh-CN.md)
- Quick start guides in English and Chinese (QUICKSTART.md, QUICKSTART.zh-CN.md)
- VHS demo infrastructure for all skills
- Demo tape files for skill-creator, github-ops, and markdown-tools
- Automated demo generation script (`demos/generate_all_demos.sh`)
- GitHub issue templates (bug report, feature request)
- GitHub pull request template
- FAQ section in README
- Table of Contents in README
- Enhanced badges (Claude Code version, PRs welcome, maintenance status)
- Chinese user guide with CC-Switch recommendation
- Language switcher badges (English/简体中文)
### Changed
- **BREAKING**: Restructured README.md to highlight skill-creator as essential meta-skill
- Moved skill-creator from position #7 to featured "Essential Skill" section
- Updated CLAUDE.md with new priorities and installation commands
- Enhanced documentation navigation and discoverability
- Improved README structure with better organization
### Removed
- skill-creator from "Other Available Skills" numbered list (now featured separately)
## [1.2.0] - 2025-10-22
### Added
- llm-icon-finder skill for AI/LLM brand icons
- Comprehensive marketplace structure with 8 skills
- Professional documentation for all skills
- CONTRIBUTING.md with quality standards
- INSTALLATION.md with detailed setup instructions
### Changed
- Updated marketplace.json to v1.2.0
- Enhanced skill descriptions and metadata
## [1.1.0] - 2025-10-15
### Added
- skill-creator skill with initialization, validation, and packaging scripts
- repomix-unmixer skill for extracting repomix packages
- teams-channel-post-writer skill for Teams communication
- Enhanced documentation structure
### Changed
- Improved skill quality standards
- Updated all skill SKILL.md files with consistent formatting
## [1.0.0] - 2025-10-08
### Added
- Initial release of Claude Code Skills Marketplace
- github-ops skill for GitHub operations
- markdown-tools skill for document conversion
- mermaid-tools skill for diagram generation
- statusline-generator skill for Claude Code customization
- MIT License
- README.md with comprehensive documentation
- Individual skill documentation (SKILL.md files)
---
## Version Numbering
We use [Semantic Versioning](https://semver.org/):
- **MAJOR** version when you make incompatible API changes
- **MINOR** version when you add functionality in a backward compatible manner
- **PATCH** version when you make backward compatible bug fixes
## Release Process
1. Update version in `.claude-plugin/marketplace.json`
2. Update CHANGELOG.md with changes
3. Update README.md version badge
4. Create git tag: `git tag -a v1.x.x -m "Release v1.x.x"`
5. Push tag: `git push origin v1.x.x`
[Unreleased]: https://github.com/daymade/claude-code-skills/compare/v1.10.0...HEAD
[1.10.0]: https://github.com/daymade/claude-code-skills/compare/v1.9.0...v1.10.0
[1.9.0]: https://github.com/daymade/claude-code-skills/compare/v1.8.0...v1.9.0
[1.8.0]: https://github.com/daymade/claude-code-skills/compare/v1.7.0...v1.8.0
[1.7.0]: https://github.com/daymade/claude-code-skills/compare/v1.6.0...v1.7.0
[1.6.0]: https://github.com/daymade/claude-code-skills/compare/v1.5.0...v1.6.0
[1.5.0]: https://github.com/daymade/claude-code-skills/compare/v1.4.0...v1.5.0
[1.4.0]: https://github.com/daymade/claude-code-skills/compare/v1.3.0...v1.4.0
[1.3.0]: https://github.com/daymade/claude-code-skills/compare/v1.2.0...v1.3.0
[1.2.0]: https://github.com/daymade/claude-code-skills/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/daymade/claude-code-skills/compare/v1.0.0...v1.1.0
[1.0.0]: https://github.com/daymade/claude-code-skills/releases/tag/v1.0.0