jekyll-ai-visible-content 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: d6df8740bf4a545461ef47c5e1e40f2c957d0653f35980d5bd4debd69c3a2f2c
+  data.tar.gz: 1efb32d2987403177eb39b901d3c082090020a77fe328b156e92c19ac188b095
+SHA512:
+  metadata.gz: 46ca4cd8957244c6664fdf68af90f4cf1eb37b29015672b75ecc21dd2158ef09eea295028bafe52dbce10bcc48fd0449f9c33c8cb7b8306926229efc3e71b1b8
+  data.tar.gz: 01e325c0f40da46e82c33c677fe5e910de2e5db9f43160398a95aaf223efab1bec1591042be869bf95badd11adb834c8a3a18c1024789b75e3f609537e40906c

data/.gitignore

@@ -0,0 +1 @@
+.cursor

data/.rubocop.yml

@@ -0,0 +1,39 @@
+AllCops:
+  TargetRubyVersion: 3.2
+  NewCops: enable
+  SuggestExtensions: false
+  Exclude:
+    - "spec/fixtures/**/*"
+    - "vendor/**/*"
+
+Metrics/MethodLength:
+  Max: 30
+
+Metrics/ClassLength:
+  Max: 200
+
+Metrics/AbcSize:
+  Max: 60
+
+Style/Documentation:
+  Enabled: false
+
+Layout/LineLength:
+  Max: 120
+
+Naming/FileName:
+  Exclude:
+    - "lib/jekyll-ai-visible-content.rb"
+
+Metrics/BlockLength:
+  Exclude:
+    - "spec/**/*.rb"
+
+Metrics/CyclomaticComplexity:
+  Max: 20
+
+Metrics/PerceivedComplexity:
+  Max: 20
+
+Gemspec/DevelopmentDependencies:
+  Enabled: false

data/CHANGELOG.md

@@ -0,0 +1,12 @@
+# Changelog
+
+## 0.1.0 (Unreleased)
+
+- Initial release
+- JSON-LD generation: Person, BlogPosting, WebSite, BreadcrumbList, FAQPage, HowTo
+- `llms.txt` and `llms-full.txt` generation
+- `robots.txt` generation with AI crawler policies
+- Liquid tags: `ai_json_ld`, `ai_author`, `ai_entity_link`, `ai_related_posts`, `ai_breadcrumbs`
+- Entity auto-linking in post content
+- Build-time validators for entity consistency, missing metadata, orphan pages
+- `jekyll-seo-tag` compatibility detection

data/Gemfile

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'public_suffix', '< 7.0'
+gem 'rake', '~> 13.0'
+gem 'rspec', '~> 3.12'
+gem 'rubocop', '~> 1.50'
+gem 'rubocop-rspec', '~> 2.20'

data/Gemfile.lock

@@ -0,0 +1,227 @@
+PATH
+  remote: .
+  specs:
+    jekyll-ai-visible-content (0.1.0)
+      jekyll (>= 4.0, < 5.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.9.0)
+      public_suffix (>= 2.0.2, < 8.0)
+    ast (2.4.3)
+    base64 (0.3.0)
+    bigdecimal (4.1.1)
+    colorator (1.1.0)
+    concurrent-ruby (1.3.6)
+    csv (3.3.5)
+    diff-lcs (1.6.2)
+    em-websocket (0.5.3)
+      eventmachine (>= 0.12.9)
+      http_parser.rb (~> 0)
+    eventmachine (1.2.7)
+    ffi (1.17.4)
+    ffi (1.17.4-aarch64-linux-gnu)
+    ffi (1.17.4-aarch64-linux-musl)
+    ffi (1.17.4-arm-linux-gnu)
+    ffi (1.17.4-arm-linux-musl)
+    ffi (1.17.4-arm64-darwin)
+    ffi (1.17.4-x86-linux-gnu)
+    ffi (1.17.4-x86-linux-musl)
+    ffi (1.17.4-x86_64-darwin)
+    ffi (1.17.4-x86_64-linux-gnu)
+    ffi (1.17.4-x86_64-linux-musl)
+    forwardable-extended (2.6.0)
+    google-protobuf (4.34.1)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-aarch64-linux-gnu)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-aarch64-linux-musl)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-arm64-darwin)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-x86-linux-gnu)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-x86-linux-musl)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-x86_64-darwin)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-x86_64-linux-gnu)
+      bigdecimal
+      rake (~> 13.3)
+    google-protobuf (4.34.1-x86_64-linux-musl)
+      bigdecimal
+      rake (~> 13.3)
+    http_parser.rb (0.8.1)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    jekyll (4.4.1)
+      addressable (~> 2.4)
+      base64 (~> 0.2)
+      colorator (~> 1.0)
+      csv (~> 3.0)
+      em-websocket (~> 0.5)
+      i18n (~> 1.0)
+      jekyll-sass-converter (>= 2.0, < 4.0)
+      jekyll-watch (~> 2.0)
+      json (~> 2.6)
+      kramdown (~> 2.3, >= 2.3.1)
+      kramdown-parser-gfm (~> 1.0)
+      liquid (~> 4.0)
+      mercenary (~> 0.3, >= 0.3.6)
+      pathutil (~> 0.9)
+      rouge (>= 3.0, < 5.0)
+      safe_yaml (~> 1.0)
+      terminal-table (>= 1.8, < 4.0)
+      webrick (~> 1.7)
+    jekyll-sass-converter (3.1.0)
+      sass-embedded (~> 1.75)
+    jekyll-watch (2.2.1)
+      listen (~> 3.0)
+    json (2.19.3)
+    kramdown (2.5.2)
+      rexml (>= 3.4.4)
+    kramdown-parser-gfm (1.1.0)
+      kramdown (~> 2.0)
+    language_server-protocol (3.17.0.5)
+    lint_roller (1.1.0)
+    liquid (4.0.4)
+    listen (3.10.0)
+      logger
+      rb-fsevent (~> 0.10, >= 0.10.3)
+      rb-inotify (~> 0.9, >= 0.9.10)
+    logger (1.7.0)
+    mercenary (0.4.0)
+    parallel (1.28.0)
+    parser (3.3.11.1)
+      ast (~> 2.4.1)
+      racc
+    pathutil (0.16.2)
+      forwardable-extended (~> 2.6)
+    prism (1.9.0)
+    public_suffix (6.0.2)
+    racc (1.8.1)
+    rainbow (3.1.1)
+    rake (13.3.1)
+    rb-fsevent (0.11.2)
+    rb-inotify (0.11.1)
+      ffi (~> 1.0)
+    regexp_parser (2.12.0)
+    rexml (3.4.4)
+    rouge (4.7.0)
+    rspec (3.13.2)
+      rspec-core (~> 3.13.0)
+      rspec-expectations (~> 3.13.0)
+      rspec-mocks (~> 3.13.0)
+    rspec-core (3.13.6)
+      rspec-support (~> 3.13.0)
+    rspec-expectations (3.13.5)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-mocks (3.13.8)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.13.0)
+    rspec-support (3.13.7)
+    rubocop (1.86.0)
+      json (~> 2.3)
+      language_server-protocol (~> 3.17.0.2)
+      lint_roller (~> 1.1.0)
+      parallel (~> 1.10)
+      parser (>= 3.3.0.2)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 2.9.3, < 3.0)
+      rubocop-ast (>= 1.49.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 2.4.0, < 4.0)
+    rubocop-ast (1.49.1)
+      parser (>= 3.3.7.2)
+      prism (~> 1.7)
+    rubocop-capybara (2.22.1)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-factory_bot (2.28.0)
+      lint_roller (~> 1.1)
+      rubocop (~> 1.72, >= 1.72.1)
+    rubocop-rspec (2.31.0)
+      rubocop (~> 1.40)
+      rubocop-capybara (~> 2.17)
+      rubocop-factory_bot (~> 2.22)
+      rubocop-rspec_rails (~> 2.28)
+    rubocop-rspec_rails (2.29.1)
+      rubocop (~> 1.61)
+    ruby-progressbar (1.13.0)
+    safe_yaml (1.0.5)
+    sass-embedded (1.99.0)
+      google-protobuf (~> 4.31)
+      rake (>= 13)
+    sass-embedded (1.99.0-aarch64-linux-android)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-aarch64-linux-gnu)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-aarch64-linux-musl)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-arm-linux-androideabi)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-arm-linux-gnueabihf)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-arm-linux-musleabihf)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-arm64-darwin)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-riscv64-linux-android)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-riscv64-linux-gnu)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-riscv64-linux-musl)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-x86_64-darwin)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-x86_64-linux-android)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-x86_64-linux-gnu)
+      google-protobuf (~> 4.31)
+    sass-embedded (1.99.0-x86_64-linux-musl)
+      google-protobuf (~> 4.31)
+    terminal-table (3.0.2)
+      unicode-display_width (>= 1.1.1, < 3)
+    unicode-display_width (2.6.0)
+    webrick (1.9.2)
+
+PLATFORMS
+  aarch64-linux-android
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-androideabi
+  arm-linux-gnu
+  arm-linux-gnueabihf
+  arm-linux-musl
+  arm-linux-musleabihf
+  arm64-darwin
+  riscv64-linux-android
+  riscv64-linux-gnu
+  riscv64-linux-musl
+  ruby
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-android
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  jekyll-ai-visible-content!
+  public_suffix (< 7.0)
+  rake (~> 13.0)
+  rspec (~> 3.12)
+  rubocop (~> 1.50)
+  rubocop-rspec (~> 2.20)
+
+BUNDLED WITH
+   2.5.22

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Eugene Leontev
+
+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.

data/README.md

@@ -0,0 +1,352 @@
+[![CI](https://github.com/madmatvey/jekyll-ai-visible-content/actions/workflows/ci.yml/badge.svg?branch=master)](https://github.com/madmatvey/jekyll-ai-visible-content/actions/workflows/ci.yml)
+
+# jekyll-ai-visible-content
+
+A Jekyll plugin gem that maximizes your site's discoverability by AI search systems (ChatGPT, Perplexity, Google AI Overviews, Claude). It generates rich JSON-LD structured data, `llms.txt`, semantic HTML helpers, and manages entity identity across your site.
+
+## Why This Exists
+
+AI search engines don't just crawl keywords — they build **entity graphs**. They link your name to your skills, your employer, your location, and your content. This plugin ensures your Jekyll site feeds those systems exactly the structured data they need, in the formats they understand best.
+
+What `jekyll-seo-tag` does for Google snippets, this gem does for AI answer engines.
+
+## Features
+
+- **Rich JSON-LD generation**: Person, BlogPosting, WebSite, BreadcrumbList, FAQPage, HowTo schemas
+- **Stable entity identity**: `@id` anchors and `sameAs` linking across all pages
+- **`llms.txt` generation**: Machine-readable site summary for LLM ingestion
+- **AI crawler policies**: `robots.txt` with GPTBot, PerplexityBot, ClaudeBot rules
+- **Semantic Liquid tags**: `ai_json_ld`, `ai_author`, `ai_entity_link`, `ai_related_posts`, `ai_breadcrumbs`
+- **Entity auto-linking**: Automatically wraps known entities in semantic markup
+- **Build-time validation**: Warns about name inconsistencies, missing metadata, orphan pages
+- **`jekyll-seo-tag` compatible**: Detects its presence and avoids duplicate schemas
+
+## Installation
+
+Add to your Jekyll site's `Gemfile`:
+
+```ruby
+gem "jekyll-ai-visible-content"
+```
+
+And to `_config.yml`:
+
+```yaml
+plugins:
+  - jekyll-ai-visible-content
+```
+
+Then run:
+
+```bash
+bundle install
+```
+
+## Quick Start
+
+Add this minimal configuration to `_config.yml`:
+
+```yaml
+ai_visible_content:
+  entity:
+    name: "Your Name"
+    job_title: "Your Title"
+    description: "One-sentence description of who you are and what you do."
+    same_as:
+      - https://linkedin.com/in/your-handle
+      - https://github.com/your-handle
+```
+
+That's it. The plugin will automatically:
+1. Inject JSON-LD into every page's `<head>`
+2. Generate `/llms.txt` and `/llms-full.txt`
+3. Generate `/robots.txt` allowing AI crawlers
+4. Generate `/entity-map.json` for debugging
+5. Validate your site's entity consistency at build time
+
+## Full Configuration Reference
+
+```yaml
+ai_visible_content:
+  enabled: true                              # Master switch
+
+  # --- Entity Identity ---
+  entity:
+    type: Person                             # Person | Organization
+    id_slug: "your-name"                     # Fragment for @id URI (auto-derived from name if omitted)
+    name: "Your Name"
+    alternate_names:                          # Other name forms (translations, etc.)
+      - "Alternate Name"
+    job_title: "Your Title"
+    description: "Your bio."
+    image: /assets/img/photo.jpg             # Relative or absolute URL
+    email: you@example.com
+    location:
+      locality: "City"
+      country: "US"                          # ISO 3166-1 alpha-2
+    knows_about:                             # Skills/topics (used for entity linking too)
+      - Ruby on Rails
+      - PostgreSQL
+    same_as:                                 # Links to authoritative profiles
+      - https://linkedin.com/in/handle
+      - https://github.com/handle
+    works_for:
+      type: Organization
+      name: "Company Name"
+    occupation:
+      name: "Backend Engineer"
+      location_country: "United States"
+      skills: "Ruby, PostgreSQL, AWS"
+
+  # --- JSON-LD Behavior ---
+  json_ld:
+    auto_inject: true                        # Inject into <head> via hook (no manual tag needed)
+    include_website_schema: true             # WebSite + SearchAction on homepage
+    include_breadcrumbs: true                # BreadcrumbList on all pages
+    include_blog_posting: true               # BlogPosting on dated posts
+    include_faq: true                        # FAQPage when faq: in front matter
+    include_how_to: true                     # HowTo when how_to: in front matter
+    article_body: excerpt                    # none | excerpt | full
+    compact: false                           # Minify JSON-LD output
+
+  # --- AI Crawler Policies ---
+  crawlers:
+    allow_gptbot: true
+    allow_perplexitybot: true
+    allow_claudebot: true
+    allow_googlebot: true
+    allow_bingbot: true
+    custom_rules: []                         # [{user_agent: "Bot", directive: "Allow", path: "/"}]
+    generate_robots_txt: true
+
+  # --- llms.txt ---
+  llms_txt:
+    enabled: true
+    title: null                              # Defaults to site.title
+    description: null                        # Defaults to site.description
+    sections: []                             # [{heading: "Section", content: "text"}]
+    include_full_text: true                  # Also generate /llms-full.txt
+
+  # --- Internal Linking ---
+  linking:
+    enable_entity_links: true                # Auto-link known entities in post body
+    entity_definitions: {}                   # Custom: slug -> {name, url, description}
+    max_links_per_entity_per_post: 1
+    enable_related_posts: true
+    related_posts_limit: 3
+
+  # --- Validation ---
+  validation:
+    warn_name_inconsistency: true
+    warn_missing_same_as: true
+    warn_missing_dates: true
+    warn_orphan_pages: true
+    warn_missing_descriptions: true
+    fail_build_on_error: false               # true = exit 1 on validation failure
+```
+
+## Layout Integration
+
+### Automatic Mode (Recommended)
+
+With `json_ld.auto_inject: true` (the default), JSON-LD is injected into every HTML page's `<head>` automatically. No layout changes required.
+
+### Manual Mode
+
+Set `json_ld.auto_inject: false` and place the tag in your layout:
+
+```html
+<head>
+  {% ai_json_ld %}
+</head>
+```
+
+### Recommended Layout Structure
+
+**`_layouts/default.html`**
+
+```html
+<!DOCTYPE html>
+<html lang="{{ page.lang | default: site.lang | default: 'en' }}">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>{{ page.title }} | {{ site.title }}</title>
+  <meta name="description" content="{{ page.description | default: site.description }}">
+  <link rel="canonical" href="{{ page.canonical_url | default: page.url | absolute_url }}">
+</head>
+<body>
+  {% ai_breadcrumbs %}
+  {{ content }}
+  {% if page.layout == 'post' %}
+    {% ai_related_posts limit:3 %}
+  {% endif %}
+</body>
+</html>
+```
+
+**`_layouts/post.html`**
+
+```html
+---
+layout: default
+---
+<article itemscope itemtype="https://schema.org/BlogPosting">
+  <header>
+    <h1 itemprop="headline">{{ page.title }}</h1>
+    <time itemprop="datePublished" datetime="{{ page.date | date_to_xmlschema }}">
+      {{ page.date | date: "%B %d, %Y" }}
+    </time>
+    {% if page.last_modified_at %}
+    <time itemprop="dateModified" datetime="{{ page.last_modified_at | date_to_xmlschema }}">
+      Updated: {{ page.last_modified_at | date: "%B %d, %Y" }}
+    </time>
+    {% endif %}
+    {% ai_author %}
+  </header>
+  <div itemprop="articleBody">
+    {{ content }}
+  </div>
+</article>
+```
+
+## Front Matter Reference
+
+### Posts
+
+```yaml
+---
+layout: post
+title: "Optimizing PostgreSQL Queries: From 2 Seconds to 20ms"
+date: 2025-01-15
+last_modified_at: 2025-02-01T12:00:00+04:00
+description: "A deep-dive into PostgreSQL query optimization."
+image: /assets/img/posts/pg-optimization.jpg
+author: Your Name
+tags: [postgresql, query-optimization, performance]
+categories: [engineering]
+topics:                                        # Maps to schema:about
+  - PostgreSQL
+  - Query Optimization
+
+# Optional: generates FAQPage JSON-LD
+faq:
+  - question: "How much can optimization improve?"
+    answer: "We achieved a 100x improvement."
+
+# Optional: generates HowTo JSON-LD
+how_to:
+  name: "How to Optimize PostgreSQL Queries"
+  total_time: "PT2H"
+  steps:
+    - name: "Identify slow queries"
+      text: "Use pg_stat_statements..."
+
+# Optional: explicit related posts
+related_slugs:
+  - rails-n-plus-one-solutions
+---
+```
+
+### Pages
+
+```yaml
+---
+layout: page
+title: "Your Name — Your Title"
+permalink: /about/
+description: "Bio description for AI extraction."
+entity_type: Person                            # Triggers full Person JSON-LD
+image: /assets/img/photo.jpg
+---
+```
+
+## Liquid Tags
+
+| Tag | Description |
+|-----|-------------|
+| `{% ai_json_ld %}` | Renders JSON-LD script tag for the current page |
+| `{% ai_author %}` | Renders semantic author markup linking to /about/ |
+| `{% ai_entity_link "Ruby on Rails" %}` | Renders a semantic link for a known entity |
+| `{% ai_related_posts limit:3 %}` | Renders related posts with schema markup |
+| `{% ai_breadcrumbs %}` | Renders HTML breadcrumb navigation |
+
+## Liquid Filters
+
+| Filter | Description |
+|--------|-------------|
+| `{{ "Ruby on Rails" \| ai_slugify }}` | Converts to `ruby-on-rails` |
+| `{{ "Ruby on Rails" \| ai_entity_url }}` | Returns the entity's topic URL |
+| `{{ "" \| ai_entity_name }}` | Returns the configured entity name |
+
+## Naming Conventions
+
+### Post Files
+
+```
+_posts/YYYY-MM-DD-descriptive-slug-with-keywords.md
+```
+
+- Lowercase, hyphen-separated slugs
+- Include primary topic keyword in slug
+- Avoid generic slugs (`post-1`, `update`, `new-thing`)
+
+### Titles
+
+```
+[Action] [Topic]: [Specific Outcome]
+```
+
+- "Optimizing PostgreSQL Queries: From 2 Seconds to 20ms"
+- "Solving N+1 Queries in Rails: A Complete Guide"
+- Include entity name in page titles (especially /about/)
+
+### Tags
+
+```yaml
+tags: [postgresql, ruby-on-rails, aws, performance]
+```
+
+Normalized, lowercase, hyphenated. Each tag can serve as a topic hub page.
+
+## Generated Files
+
+| File | Description |
+|------|-------------|
+| `/llms.txt` | Concise site summary for LLM consumption |
+| `/llms-full.txt` | Full-text version with complete post bodies |
+| `/robots.txt` | AI crawler allow rules + sitemap reference |
+| `/entity-map.json` | Debug file showing entity mentions and cross-references |
+
+## Build Validation
+
+During `jekyll build`, the plugin checks for:
+
+- **Name inconsistency**: `site.author` differs from `entity.name`
+- **Missing sameAs**: No links to LinkedIn, GitHub, etc.
+- **Missing dateModified**: Posts without `last_modified_at` (hurts freshness scoring)
+- **Missing description**: Pages without `description` in front matter
+- **Orphan pages**: Pages with zero inbound internal links
+- **Generic titles**: Titles like "About" without entity name
+
+Set `validation.fail_build_on_error: true` to make errors break the build in CI.
+
+## Compatibility
+
+- Works alongside `jekyll-seo-tag` (avoids duplicate WebSite JSON-LD)
+- Works alongside `jekyll-sitemap` (does not generate its own sitemap)
+- Works alongside `jekyll-feed`
+- Requires Jekyll 4.0+ and Ruby 3.2+
+
+## Development
+
+```bash
+git clone https://github.com/madmatvey/jekyll-ai-visible-content.git
+cd jekyll-ai-visible-content
+bundle install
+bundle exec rspec -f d
+```
+
+## License
+
+MIT License. See [LICENSE.txt](LICENSE.txt).

data/Rakefile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'rspec/core/rake_task'
+require 'rubocop/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+task default: %i[spec rubocop]