Commit Graph

120 Commits

Author SHA1 Message Date
Yilin Jing 8a1ac7ba6a feat(blog): Add OG image for installation tutorial 2026-01-29 00:15:36 +08:00
Yilin Jing 66e7e5c3f6 feat(blog): Add OG image for installation tutorial
- Add 2026-01-28-install-opc-skills-claude-code-og.png (1424x752)
- Generated using nanobanana skill with reference-based style
- Revert worker.js temporary changes back to main branch
2026-01-29 00:01:37 +08:00
Yilin Jing e350c4f834 feat(blog): Update installation tutorial description
- Highlight key benefits: 27/month savings, 85% time reduction
- Mention specific skills: reddit, domain hunting, SEO, logo creation
- Add 'no API key' selling point for reddit
- Match TL;DR section tone and value prop
- More compelling for social sharing previews
2026-01-28 22:55:17 +08:00
Yilin Jing 2324848ff5 docs(blog): Add TL;DR section to installation tutorial
- Matches format of other successful blog posts
- Summarizes key value prop in first paragraph
- Highlights: 2-minute install, 27/month savings, 85% time reduction
- Includes all 9 skill types for quick scanning
2026-01-28 22:54:15 +08:00
Yilin Jing 64db02bad4 feat(blog): Add installation tutorial blog post
- Complete tutorial: How to Install OPC Skills in Claude Code (2-Minute Tutorial)
- Covers all 9 skills with detailed descriptions
- Includes troubleshooting section for common issues
- FAQ with 10 questions optimized for AI search
- Cost comparison table (27/month savings)
- VHS tape file for animated GIF walkthrough
- VHS README with recording instructions
- HowTo schema for Google Rich Results
- Updated blog.json with full metadata

Features:
- Step-by-step installation guide
- Beginner-friendly with no prerequisites
- Real user success stories
- Skills categorized by use case
- API key requirements clearly documented

TODO: Generate OG image (2026-01-28-install-tutorial-og.png)
2026-01-28 22:48:29 +08:00
Yilin 3954a3da9e feat(marketplace): Add Claude Code Plugin Marketplace integration (#32)
* feat(marketplace): Add Claude Code Plugin Marketplace integration

- Create official marketplace.json with all 9 skills
- Add Claude Code marketplace installation section to README
- Add Claude Code Marketplace badge to README
- Configure plugin metadata with proper categories and keywords

Closes #31

* feat(marketplace): Add plugin.json to each skill directory

- Generate plugin.json for all 9 skills with proper metadata
- Add marketplace-level keywords for better discoverability
- Include scripts directory as commands when available
- Follow Claude Code plugin manifest schema requirements

Each skill now has:
- Explicit version, description, and keywords
- Homepage and repository links
- Commands path (for skills with scripts)
- SKILL.md reference for skill instructions
2026-01-28 21:53:40 +08:00
Yilin a0fa99d14a feat(workflow): Add auto-close-issues workflow (#30)
- Automatically closes issues when referenced PR is merged
- Adds comment to issue specifying which PR caused closure
- Supports keywords: Fixes, Closes, Resolves (case-insensitive)
- Extracts issue numbers from both PR title and body
2026-01-28 18:57:03 +08:00
Yilin 4d348eeada docs: enhance README with additional project health badges (#29) 2026-01-28 18:49:17 +08:00
Yilin 57b338c91f feat(website): Complete SEO/GEO Phase 1, 2 & 3 optimizations (#28)
* feat(website): Implement SEO/GEO Phase 2 meta tag optimizations

- Optimize homepage title from 71 to 60 chars for better SERP display
- Optimize homepage description from 194 to 155 chars (Google recommended)
- Optimize blog page description from 127 to 155 chars with more details
- Update OG descriptions to match new meta tags
- Maintain brand consistency across all meta tags

Expected impact: +5% click-through rate from search results

* feat(website): Add OG tags and JSON-LD schema to compare page (Phase 1)

- Add comprehensive Open Graph meta tags for better social sharing
- Add Twitter Card tags for improved preview on Twitter/X
- Add JSON-LD WebPage schema with Table mainEntity
- Add SpeakableSpecification for voice search optimization
- Improves social media visibility and AI search citations

* feat(website): Add authority citations and HowTo schema (Phase 3)

- Add Princeton NLP and AgentSkills.io citations to seo-geo FAQ answer
- Add HowTo schema with 3-step installation guide (PT30S)
- BreadcrumbList schema confirmed present in skill pages
- Improves AI search engine trust and featured snippet eligibility
2026-01-28 18:49:03 +08:00
Yilin dda1f1c140 docs: Add Star History chart to README (#26)
* fix(website): improve API key info alignment on skill detail page (#17)

* chore: update install stats from skills.sh

* feat(blog): add Ralph autonomous agent loop tutorial for solopreneurs (#20) (#21)

* feat(blog): add Ralph autonomous agent loop tutorial for solopreneurs

Add comprehensive tutorial on using Ralph, an autonomous AI agent loop with 7.9k GitHub stars, to build MVPs automatically. Includes real case study (SaaS dashboard in 24 hours), OPC Skills integration, step-by-step setup guide, and 10 GEO-optimized FAQ questions.

* feat(scripts): add blog validation and creation tools

Add comprehensive blog post management tools:
- create-blog.py: Validate, check, and create blog posts
- BLOG_GUIDELINES.md: Complete documentation for blog best practices

Features:
- Validate blog.json structure and required fields
- Check markdown content quality (word count, headings, links)
- Detect missing SEO/GEO optimization (keywords, FAQs, citations)
- Create new blog post templates interactively

* feat(workflows): add fast-track blog publishing with auto-merge

Add automated blog publishing workflow to reduce time-to-live from 2+ days to 6 minutes:

New workflow:
- PR directly to main with 'blog-post' label
- Auto-validates blog.json and markdown
- Auto-approves and auto-merges if validation passes
- Deploys to Cloudflare Workers automatically

Documentation:
- BLOG_PUBLISHING.md: Complete guide with 5 different publishing strategies
- Comparison of workflows (Git Flow vs Fast-Track)
- Implementation checklist and usage examples

This allows blog posts to bypass develop branch while maintaining quality through automated validation.

* feat(blog): add custom OG images for all blog posts (#22)

* feat(blog): add custom OG images for all blog posts

Add 5 custom OG images matching OPC pixel art branding:
- 2026-01-26-ralph-og.png (Ralph autonomous agent loop)
- 2026-01-24-docs-skills-og.png (Convert docs to skills)
- 2026-01-23-skills-docs-og.png (Skills beat docs)
- 2026-01-21-domain-hunter-og.png (Domain Hunter savings)
- 2026-01-21-what-is-opc-og.png (What is OPC)

All images:
- 8-bit pixel art style with OPC king character
- Cream/beige gradient background
- Custom text for each blog topic
- Date-prefixed filenames for organization
- Served via GitHub raw URLs

Updated blog.json with new OG image URLs for better social sharing.

* fix(blog): update OG image URLs to use GitHub raw URLs

Update all blog post OG image URLs to use GitHub raw instead of opc.dev domain.
This ensures images work properly with the Cloudflare Worker deployment.

* feat(blog): add OG image thumbnails to blog list page (#23)

Display custom OG images as thumbnails on /blog page:
- Show OG image at top of each blog card
- Add hover effect on images (opacity transition)
- Responsive layout with proper spacing
- Images are clickable links to blog posts

Improves visual appeal and helps users identify content quickly.

* fix(blog): reduce OG image thumbnail size on blog list (#24)

Limit OG image height to 200px on blog list page:
- Set max-height on image container
- Use object-fit: cover for consistent sizing
- Center crop images with object-position
- Prevents images from dominating the card

Images now act as proper thumbnails instead of full-size banners.

* chore: update install stats from skills.sh

* blog(post): Add free AI infrastructure guide (DeepSeek + Jan + OPC Skills)

Add comprehensive tutorial on building MVPs with zero API costs using:
- DeepSeek OCR-2 for local document processing
- Jan v3-4B for 40% improved local coding
- OPC Skills for marketing and automation
- Real cost breakdown: $0-15 vs $165-200 traditional approach

Includes step-by-step setup guide, hardware requirements, and hybrid
approach for scaling from free to paid Claude API when needed.

* blog(og): Add OG image for free AI infrastructure blog post

* blog(og): Add OG image for free AI infrastructure blog post

* chore: update install stats from skills.sh

* docs: add Star History chart to README

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-01-28 18:01:10 +08:00
Yilin Jing 54856afa34 chore: merge main into develop 2026-01-28 17:57:11 +08:00
github-actions[bot] 504e14edfb chore: update install stats from skills.sh 2026-01-28 06:13:50 +00:00
Yilin Jing 34f6e76490 blog(og): Update OG image with pixel art style matching existing blogs 2026-01-28 00:37:22 +08:00
Yilin Jing 13f347238c blog(og): Add OG image for free AI infrastructure blog post 2026-01-28 00:36:59 +08:00
Yilin Jing b8626c2977 blog(og): Add OG image for free AI infrastructure blog post 2026-01-28 00:31:20 +08:00
Yilin Jing 7bc13606cd Merge branch 'main' of github.com:ReScienceLab/opc-skills 2026-01-28 00:27:29 +08:00
Yilin Jing 176e69623d blog(post): Add free AI infrastructure guide (DeepSeek + Jan + OPC Skills)
Add comprehensive tutorial on building MVPs with zero API costs using:
- DeepSeek OCR-2 for local document processing
- Jan v3-4B for 40% improved local coding
- OPC Skills for marketing and automation
- Real cost breakdown: $0-15 vs $165-200 traditional approach

Includes step-by-step setup guide, hardware requirements, and hybrid
approach for scaling from free to paid Claude API when needed.
2026-01-28 00:26:28 +08:00
github-actions[bot] 69d8181deb chore: update install stats from skills.sh 2026-01-27 06:13:06 +00:00
Yilin 5a84819756 fix(blog): reduce OG image thumbnail size on blog list (#24)
Limit OG image height to 200px on blog list page:
- Set max-height on image container
- Use object-fit: cover for consistent sizing
- Center crop images with object-position
- Prevents images from dominating the card

Images now act as proper thumbnails instead of full-size banners.
2026-01-27 01:00:04 +08:00
Yilin 7b975fd81f feat(blog): add OG image thumbnails to blog list page (#23)
Display custom OG images as thumbnails on /blog page:
- Show OG image at top of each blog card
- Add hover effect on images (opacity transition)
- Responsive layout with proper spacing
- Images are clickable links to blog posts

Improves visual appeal and helps users identify content quickly.
2026-01-27 00:49:27 +08:00
Yilin 6872bfc7dd feat(blog): add custom OG images for all blog posts (#22)
* feat(blog): add custom OG images for all blog posts

Add 5 custom OG images matching OPC pixel art branding:
- 2026-01-26-ralph-og.png (Ralph autonomous agent loop)
- 2026-01-24-docs-skills-og.png (Convert docs to skills)
- 2026-01-23-skills-docs-og.png (Skills beat docs)
- 2026-01-21-domain-hunter-og.png (Domain Hunter savings)
- 2026-01-21-what-is-opc-og.png (What is OPC)

All images:
- 8-bit pixel art style with OPC king character
- Cream/beige gradient background
- Custom text for each blog topic
- Date-prefixed filenames for organization
- Served via GitHub raw URLs

Updated blog.json with new OG image URLs for better social sharing.

* fix(blog): update OG image URLs to use GitHub raw URLs

Update all blog post OG image URLs to use GitHub raw instead of opc.dev domain.
This ensures images work properly with the Cloudflare Worker deployment.
2026-01-27 00:45:39 +08:00
Yilin 5427b1e5c8 feat(blog): add Ralph autonomous agent loop tutorial for solopreneurs (#20) (#21)
* feat(blog): add Ralph autonomous agent loop tutorial for solopreneurs

Add comprehensive tutorial on using Ralph, an autonomous AI agent loop with 7.9k GitHub stars, to build MVPs automatically. Includes real case study (SaaS dashboard in 24 hours), OPC Skills integration, step-by-step setup guide, and 10 GEO-optimized FAQ questions.

* feat(scripts): add blog validation and creation tools

Add comprehensive blog post management tools:
- create-blog.py: Validate, check, and create blog posts
- BLOG_GUIDELINES.md: Complete documentation for blog best practices

Features:
- Validate blog.json structure and required fields
- Check markdown content quality (word count, headings, links)
- Detect missing SEO/GEO optimization (keywords, FAQs, citations)
- Create new blog post templates interactively

* feat(workflows): add fast-track blog publishing with auto-merge

Add automated blog publishing workflow to reduce time-to-live from 2+ days to 6 minutes:

New workflow:
- PR directly to main with 'blog-post' label
- Auto-validates blog.json and markdown
- Auto-approves and auto-merges if validation passes
- Deploys to Cloudflare Workers automatically

Documentation:
- BLOG_PUBLISHING.md: Complete guide with 5 different publishing strategies
- Comparison of workflows (Git Flow vs Fast-Track)
- Implementation checklist and usage examples

This allows blog posts to bypass develop branch while maintaining quality through automated validation.
2026-01-27 00:16:24 +08:00
Yilin c390402036 feat(blog): add Ralph autonomous agent loop tutorial for solopreneurs (#20)
* feat(blog): add Ralph autonomous agent loop tutorial for solopreneurs

Add comprehensive tutorial on using Ralph, an autonomous AI agent loop with 7.9k GitHub stars, to build MVPs automatically. Includes real case study (SaaS dashboard in 24 hours), OPC Skills integration, step-by-step setup guide, and 10 GEO-optimized FAQ questions.

* feat(scripts): add blog validation and creation tools

Add comprehensive blog post management tools:
- create-blog.py: Validate, check, and create blog posts
- BLOG_GUIDELINES.md: Complete documentation for blog best practices

Features:
- Validate blog.json structure and required fields
- Check markdown content quality (word count, headings, links)
- Detect missing SEO/GEO optimization (keywords, FAQs, citations)
- Create new blog post templates interactively

* feat(workflows): add fast-track blog publishing with auto-merge

Add automated blog publishing workflow to reduce time-to-live from 2+ days to 6 minutes:

New workflow:
- PR directly to main with 'blog-post' label
- Auto-validates blog.json and markdown
- Auto-approves and auto-merges if validation passes
- Deploys to Cloudflare Workers automatically

Documentation:
- BLOG_PUBLISHING.md: Complete guide with 5 different publishing strategies
- Comparison of workflows (Git Flow vs Fast-Track)
- Implementation checklist and usage examples

This allows blog posts to bypass develop branch while maintaining quality through automated validation.
2026-01-27 00:15:42 +08:00
Yilin 87f054df48 Merge pull request #19 from ReScienceLab/develop
feat(blog): add tutorial on converting docs to agent skills
2026-01-24 20:23:09 +08:00
Yilin 43059d174d feat(blog): add tutorial on converting docs to agent skills (#18) 2026-01-24 20:21:23 +08:00
github-actions[bot] 2da4d9b6b1 chore: update install stats from skills.sh 2026-01-24 07:31:54 +00:00
Yilin Jing 62fe9d85f2 Merge remote-tracking branch 'origin/main' into develop 2026-01-23 20:18:09 +08:00
Yilin 4fb091758c fix(website): improve API key info alignment on skill detail page (#17) 2026-01-23 20:16:43 +08:00
Yilin 80eb9362d2 fix(website): display skill dependencies and API keys with clickable URLs (#16)
* fix(website): display skill dependencies by handling object format in skills.json (#15)

* feat(website): upgrade auth structure with keys array and display dependency API keys
2026-01-23 19:41:03 +08:00
Yilin Jing 09e4fef815 Merge branch 'main' into develop 2026-01-23 19:10:44 +08:00
Yilin 6f1d65ca40 feat(blog): add FAQPage schema and dateModified for GEO optimization (#14)
* feat(website): display skill installation counts from skills.sh (#13)

- Add scripts/fetch-install-stats.py to scrape install counts
- Add GitHub Action to run daily and update install-stats.json
- Update worker.js to show install count badges on skill cards and detail pages
- Generate initial install-stats.json

Closes #12

* feat(blog): add FAQPage schema and dateModified for GEO optimization

- Add FAQ items to blog posts 2 & 3 (domain-hunting, what-is-opc)
- Add dateModified field to all blog posts for freshness signals
- Add additional citations to improve AI search visibility
2026-01-23 18:46:04 +08:00
Yilin 002eda2757 feat(website): display skill installation counts from skills.sh (#13)
- Add scripts/fetch-install-stats.py to scrape install counts
- Add GitHub Action to run daily and update install-stats.json
- Update worker.js to show install count badges on skill cards and detail pages
- Generate initial install-stats.json

Closes #12
2026-01-23 18:23:59 +08:00
Yilin 310f694123 Merge pull request #11 from ReScienceLab/develop
feat(blog): SEO/GEO optimizations for why-skills-beat-docs
2026-01-23 18:08:30 +08:00
Yilin Jing 8b41d1ad86 feat(blog): add SEO/GEO optimizations to why-skills-beat-docs
- Add TL;DR summary for AI snippet extraction
- Add FAQ section (6 questions) for high citation probability
- Add JSON-LD BlogPosting schema markup
- Add FAQ schema for rich snippets
- Expand keywords for better discoverability
2026-01-23 18:07:18 +08:00
Yilin 7e30ff86b7 Merge pull request #10 from ReScienceLab/develop
feat(blog): Why Skills Beat Docs - Agent-Native Documentation
2026-01-23 18:04:22 +08:00
Yilin Jing 354e666763 feat(blog): add 'Why Skills Beat Docs' post on agent-native documentation
- Analyze 100x engagement gap between traditional docs and skills
- Cover ecosystem tools: Skills.sh, Mintlify, awesome-claude-code
- Include docs-to-skills conversion guide
- Add SEO metadata to blog.json
2026-01-23 18:01:38 +08:00
Yilin 07657a659e Merge pull request #8 from ReScienceLab/develop
Enhance skill versioning & release management with best practices
2026-01-21 20:29:11 +08:00
Yilin Jing 65b6aca906 fix: Correct jq syntax and add explicit bash shell for Windows compatibility
- Fixed jq query to correctly extract dependency names from object format
  Changed: keys[]? | .[] (which extracted version values)
  To: select(.dependencies | type == "object") | .dependencies | keys[]

- Added explicit 'shell: bash' for test jobs on Windows
  Windows runners default to PowerShell which can't execute Bash syntax
  This ensures bash is used for all test steps regardless of OS
2026-01-21 20:17:16 +08:00
Yilin Jing e61839219f fix: Update skills.json validation to support semantic versioning in dependencies
Changed validation script to handle new object-based dependency format
(from array to {dependency: version} format) while maintaining
backwards compatibility with legacy array format.

Previous format: "dependencies": ["twitter", "reddit"]
New format:     "dependencies": {"twitter": ">=1.0.0", "reddit": ">=1.0.0"}
2026-01-21 20:15:08 +08:00
Yilin Jing 82e2cad26a refactor: Enhance skill versioning & release management with best practices
- AGENTS.md: Expanded Release Process with detailed single-skill and coordinated releases
  - Added breaking changes handling and compatibility testing guidelines
  - Included 3 release scenarios: quick release, coordinated release, breaking changes
  - Added release checklist for pre-merge verification

- CHANGELOG.md: Restructured with Compatibility & Dependency Matrix
  - Added matrix table showing skill versions and their dependencies
  - Reorganized version history by skill (vertical tracking)
  - Updated Unreleased sections with per-skill structure

- skills.json: Standardized dependencies with semantic versioning
  - Changed from simple array to semantic versioning format
  - domain-hunter: twitter >=1.0.0, reddit >=1.0.0
  - logo-creator, banner-creator: nanobanana >=1.0.0
  - seo-geo: twitter >=1.0.0, reddit >=1.0.0

- template/SKILL.md: Created comprehensive skill template
  - Includes updated frontmatter with semantic versioning dependencies
  - Documents dependency format and best practices
  - Provides guidance for skill creation
2026-01-21 20:12:05 +08:00
Yilin Jing 3246a68a36 docs: Add comprehensive AGENTS.md and CHANGELOG.md for version management and project workflow
- AGENTS.md: Complete project configuration with skill development patterns, versioning strategy, git workflow, and commit conventions
- CHANGELOG.md: Version history starting from v1.0.0 with all 9 OPC Skills and their features
- Includes dependency tracking, release process, and best practices for skill management
2026-01-21 19:56:39 +08:00
Yilin Jing 9217ff24cf feat(blog): add blog system with 2 SEO/GEO optimized posts (What is OPC + Domain Hunter tutorial) 2026-01-21 19:23:35 +08:00
Yilin Jing 641a84558a feat(blog): add blog system with first post, navbar integration, and SEO/GEO optimization 2026-01-21 18:51:09 +08:00
Yilin Jing 05fa9e5ab0 feat(geo): add llms.txt, /compare page, expand FAQs to 30+ 2026-01-21 18:18:44 +08:00
Yilin Jing f7c2f93df5 fix(schema): remove duplicate FAQPage microdata, keep only JSON-LD 2026-01-21 18:05:17 +08:00
Yilin Jing ef28ba9ff9 fix: correct speakable CSS selectors in schema markup 2026-01-21 17:52:07 +08:00
Yilin Jing 1253ce4c13 feat: add animated logo scroller showcasing 9 supported AI platforms with gradient effects and hover pause 2026-01-21 16:22:08 +08:00
Yilin Jing afd7b60e07 feat: update hero section with compatibility note and adjust styling 2026-01-21 13:39:04 +08:00
Yilin Jing ab75cf5142 feat: add skills.sh badge to README for SEO 2026-01-21 13:27:02 +08:00
Yilin Jing 10218ed453 refactor: standardize installation to npx skills add, remove install.sh and manual install docs 2026-01-21 13:21:18 +08:00