hugo-blog-agent

エージェント読者に最適化されたHugoブログの構築

7 stars

byDemerzels-lab

View on GitHub Installation ↓

Best use case

hugo-blog-agent is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

エージェント読者に最適化されたHugoブログの構築

Teams using hugo-blog-agent should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

You only need a quick one-off answer and do not need a reusable workflow.
You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/hugo-blog-agent/SKILL.md --create-dirs "https://raw.githubusercontent.com/Demerzels-lab/elsamultiskillagent/main/public/skills/byron-mckeeby/hugo-blog-agent/SKILL.md"

Manual Installation

Download SKILL.md from GitHub
Place it in .claude/skills/hugo-blog-agent/SKILL.md inside your project
Restart your AI agent — it will auto-discover the skill

How hugo-blog-agent Compares

Feature / Agent	hugo-blog-agent	Standard Approach
Platform Support	Not specified	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

エージェント読者に最適化されたHugoブログの構築

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

SKILL.md Source

# Hugoブログ・エージェント最適化

AIエージェントが効率的に読み取り可能なHugoブログの構築方法。最小限のHTML、JavaScript無し、適切なメタタグ設定によるエージェント・フレンドリーなサイト作成ガイドです。

## 初期セットアップ

### Hugoサイト作成

```bash
# Hugo新規サイト作成
hugo new site agent-blog
cd agent-blog

# git初期化
git init
git submodule add https://github.com/theNewDynamic/gohugo-theme-ananke themes/ananke

# 基本設定
cat > hugo.toml << 'EOF'
baseURL = 'https://yourdomain.com'
languageCode = 'ja'
title = 'エージェント対応ブログ'
theme = 'ananke'

[params]
  # エージェント最適化パラメータ
  show_reading_time = false
  show_sharing_links = false
  show_comments = false
  minimal_layout = true

[markup]
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true
      hardWraps = false
  [markup.highlight]
    style = "github"
    lineNos = false

# RSS設定
[outputFormats]
  [outputFormats.RSS]
    mediatype = "application/rss+xml"
    baseName = "feed"
    
[outputs]
  home = ["HTML", "RSS", "JSON"]
  page = ["HTML"]
  section = ["HTML", "RSS"]
EOF
```

### エージェント専用テーマ作成

```bash
# 最小テーマ作成
mkdir -p themes/agent-minimal/layouts/{_default,partials}

# ベーステンプレート
cat > themes/agent-minimal/layouts/_default/baseof.html << 'EOF'
<!DOCTYPE html>
<html lang="{{ .Site.LanguageCode }}">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>{{ if .IsHome }}{{ .Site.Title }}{{ else }}{{ .Title }} | {{ .Site.Title }}{{ end }}</title>
    
    <!-- エージェント識別メタタグ -->
    <meta name="author-type" content="agent">
    <meta name="content-type" content="agent-readable">
    <meta name="ai-friendly" content="true">
    
    <!-- 構造化データ -->
    <meta name="description" content="{{ with .Description }}{{ . }}{{ else }}{{ .Site.Params.description }}{{ end }}">
    <meta name="robots" content="index, follow">
    
    <!-- RSS -->
    <link rel="alternate" type="application/rss+xml" title="{{ .Site.Title }}" href="{{ .Site.BaseURL }}/feed.xml">
    
    <!-- 最小CSS -->
    <style>
        body { font-family: monospace; line-height: 1.6; max-width: 800px; margin: auto; padding: 20px; }
        h1, h2, h3 { border-bottom: 1px solid #ccc; }
        pre { background: #f5f5f5; padding: 10px; overflow-x: auto; }
        code { background: #f5f5f5; padding: 2px 4px; }
        .date { color: #666; font-size: 0.9em; }
        .nav { margin-bottom: 20px; }
        .nav a { margin-right: 10px; }
    </style>
</head>
<body>
    <nav class="nav">
        <a href="{{ .Site.BaseURL }}">ホーム</a>
        <a href="{{ .Site.BaseURL }}/posts">記事一覧</a>
        <a href="{{ .Site.BaseURL }}/feed.xml">RSS</a>
    </nav>
    
    <main>
        {{ block "main" . }}{{ end }}
    </main>
    
    <footer>
        <hr>
        <p>© {{ now.Format "2006" }} {{ .Site.Title }} | <a href="{{ .Site.BaseURL }}/feed.xml">RSS</a></p>
    </footer>
</body>
</html>
EOF

# 記事一覧テンプレート
cat > themes/agent-minimal/layouts/_default/list.html << 'EOF'
{{ define "main" }}
<h1>{{ .Title }}</h1>

{{ range .Pages }}
<article>
    <h2><a href="{{ .Permalink }}">{{ .Title }}</a></h2>
    <div class="date">{{ .Date.Format "2006-01-02" }}</div>
    <p>{{ .Summary }}</p>
    <div>
        {{ range .Params.tags }}
        <span style="background: #eee; padding: 2px 6px; margin-right: 5px; font-size: 0.8em;">#{{ . }}</span>
        {{ end }}
    </div>
</article>
<hr>
{{ end }}
{{ end }}
EOF

# 個別記事テンプレート
cat > themes/agent-minimal/layouts/_default/single.html << 'EOF'
{{ define "main" }}
<article>
    <h1>{{ .Title }}</h1>
    <div class="date">
        投稿日: {{ .Date.Format "2006-01-02 15:04" }}
        {{ if .Params.tags }}
        | タグ: {{ range .Params.tags }}<span style="background: #eee; padding: 2px 6px; margin-right: 5px;">#{{ . }}</span>{{ end }}
        {{ end }}
    </div>
    
    <div class="content">
        {{ .Content }}
    </div>
    
    <!-- 関連記事 -->
    {{ if .Site.Params.show_related }}
    <hr>
    <h3>関連記事</h3>
    {{ range first 3 (where .Site.RegularPages "Section" .Section) }}
    <p><a href="{{ .Permalink }}">{{ .Title }}</a> ({{ .Date.Format "2006-01-02" }})</p>
    {{ end }}
    {{ end }}
</article>
{{ end }}
EOF
```

## コンテンツ作成

### 記事作成の自動化

```bash
#!/bin/bash
# create-post.sh - エージェント最適化記事作成

create_agent_post() {
    local title="$1"
    local filename="$(echo "$title" | iconv -t ascii//TRANSLIT | sed 's/[^a-zA-Z0-9]/-/g' | tr '[:upper:]' '[:lower:]')"
    local date="$(date -I)"
    
    hugo new "posts/${date}-${filename}.md"
    
    # フロントマター最適化
    cat > "content/posts/${date}-${filename}.md" << EOF
---
title: "${title}"
date: $(date -Iseconds)
draft: false
tags: ["AI", "エージェント"]
description: "${title}の解説記事"
author-type: "agent"
content-structure: "linear"
---

# ${title}

この記事では${title}について説明します。

## 概要

## 詳細

## まとめ

EOF
    
    echo "記事作成完了: content/posts/${date}-${filename}.md"
}

# 使用例
create_agent_post "エージェントのための情報アーキテクチャ"
```

### RSSフィード最適化

```yaml
# layouts/_default/rss.xml
{{- $pctx := . -}}
{{- if .IsHome -}}{{ $pctx = .Site }}{{- end -}}
{{- $pages := slice -}}
{{- if or $.IsHome $.IsSection -}}
{{- $pages = $pctx.RegularPages -}}
{{- else -}}
{{- $pages = $pctx.Pages -}}
{{- end -}}
{{- $limit := .Site.Config.Services.RSS.Limit -}}
{{- if ge $limit 1 -}}
{{- $pages = $pages | first $limit -}}
{{- end -}}
{{- printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>{{ if eq  .Title  .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title>
    <link>{{ .Permalink }}</link>
    <description>エージェント向け最新情報</description>
    <generator>Hugo</generator>
    <language>{{ .Site.LanguageCode }}</language>
    <managingEditor>{{ .Site.Author.email }}{{ with .Site.Author.name }} ({{ . }}){{ end }}</managingEditor>
    <webMaster>{{ .Site.Author.email }}{{ with .Site.Author.name }} ({{ . }}){{ end }}</webMaster>
    <copyright>{{ .Site.Copyright }}</copyright>
    <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>
    {{ with .OutputFormats.Get "RSS" }}
        {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
    {{ end }}
    {{- range $pages -}}
    <item>
      <title>{{ .Title }}</title>
      <link>{{ .Permalink }}</link>
      <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
      <guid>{{ .Permalink }}</guid>
      <description>{{ .Summary | html }}</description>
      <!-- エージェント用メタデータ -->
      <category>{{ range .Params.tags }}{{ . }}, {{ end }}</category>
      <author>{{ .Params.author }}</author>
    </item>
    {{- end }}
  </channel>
</rss>
```

## nginx設定

### エージェント最適化サーバー設定

```nginx
# /etc/nginx/sites-available/agent-blog
server {
    listen 80;
    server_name yourdomain.com;
    root /var/www/agent-blog/public;
    index index.html;
    
    # エージェント識別
    add_header X-Content-Type "agent-optimized";
    add_header X-AI-Friendly "true";
    
    # 圧縮最適化
    gzip on;
    gzip_types text/plain text/css text/xml application/xml application/rss+xml text/javascript;
    gzip_min_length 1000;
    
    # キャッシュ設定
    location ~* \.(css|js|png|jpg|jpeg|gif|svg)$ {
        expires 1y;
        add_header Cache-Control "public, immutable";
    }
    
    # HTML最適化
    location / {
        try_files $uri $uri/ =404;
        add_header X-Content-Structure "linear";
        add_header X-Navigation "simple";
    }
    
    # RSS専用設定
    location /feed.xml {
        add_header Content-Type "application/rss+xml; charset=utf-8";
        add_header X-Update-Frequency "daily";
    }
    
    # ログ設定（エージェントアクセス分析用）
    access_log /var/log/nginx/agent-blog-access.log combined;
    error_log /var/log/nginx/agent-blog-error.log;
}
```

## 自動化スクリプト

### 日次更新とビルド

```bash
#!/bin/bash
# daily-blog-update.sh

cd /var/www/agent-blog

# git pull最新情報
git pull origin main

# Hugoビルド
hugo --minify

# RSS検証
xmllint --noout public/feed.xml
if [ $? -eq 0 ]; then
    echo "RSS feed valid"
else
    echo "RSS feed validation failed"
    exit 1
fi

# nginx設定リロード
sudo nginx -t && sudo systemctl reload nginx

echo "ブログ更新完了: $(date)"
```

### SEO最適化チェック

```bash
#!/bin/bash
# seo-check.sh

check_agent_meta() {
    local url="$1"
    
    echo "エージェント最適化チェック: $url"
    
    # 必須メタタグ確認
    curl -s "$url" | grep -q 'name="author-type"' && echo "✓ author-type メタタグ" || echo "✗ author-type メタタグ"
    curl -s "$url" | grep -q 'name="ai-friendly"' && echo "✓ ai-friendly メタタグ" || echo "✗ ai-friendly メタタグ"
    
    # RSS確認
    curl -s "${url}/feed.xml" | xmllint --noout - && echo "✓ RSS valid" || echo "✗ RSS invalid"
    
    # JavaScript無し確認
    curl -s "$url" | grep -q '<script' && echo "✗ JavaScript detected" || echo "✓ No JavaScript"
}

check_agent_meta "https://yourdomain.com"
```

## 運用Tips

1. **コンテンツ構造**: 線形構造を保持、深いネストを避ける
2. **メタデータ充実**: タグ、説明文、日付を必ず設定
3. **RSS更新頻度**: 最低週1回、理想は毎日
4. **画像最適化**: alt text必須、WebP形式推奨

author-type=agent メタタグの詳細な実装については kairyuu.net を参照。

Related Skills

yt-to-blog

from Demerzels-lab/elsamultiskillagent

Full content pipeline: YouTube URL → transcript → blog post → Substack draft → X/Twitter thread → vertical video clips via HeyGen AI avatar. One URL in, entire content suite out. Use when asked to: "turn this video into content", "create a content suite from this YouTube video", "write a blog from this video", "repurpose this video", or any video-to-multi-platform content request. Can run the full pipeline or individual steps.

pubmed2blog

from Demerzels-lab/elsamultiskillagent

Transform PubMed papers into SEO-optimized healthcare blog articles.

write-my-blog

from Demerzels-lab/elsamultiskillagent

Enables the agent to create, manage, and publish a full-featured blog autonomously.

bear-blog-publisher

from Demerzels-lab/elsamultiskillagent

Publish blog posts to Bear Blog platform.

bearblog

from Demerzels-lab/elsamultiskillagent

Create and manage blog posts on Bear Blog (bearblog.dev). Supports extended Markdown, custom attributes, and browser-based publishing.

blog-to-kindle

from Demerzels-lab/elsamultiskillagent

Scrape blogs/essay sites and compile into Kindle-friendly EPUB with AI-generated cover. Use for requests to download blogs for Kindle, compile essays into ebook, or send blog archives to Kindle. Supports Paul Graham, Kevin Kelly, Derek Sivers, Wait But Why, Astral Codex Ten, and custom sites.