Repository Analysis

virgiliojr94/book-to-skill

Turn any technical book PDF into a Claude Code skill — ready to study, reference, and use while you work.

37.4 Strong AI signal View on GitHub

Analysis Overview

This report presents the forensic synthetic code analysis of virgiliojr94/book-to-skill, a Python project with 8,603 GitHub stars. SynthScan v2.0 examined 5,617 lines of code across 41 source files, recording 179 pattern matches distributed across 9 syntactic categories. The overall adjusted score of 37.4 places this repository in the Strong AI signal band.

The scanner applied 160+ deterministic lexical heuristics, multi-line block detectors, abstract syntax tree depth profilers, and a cross-file Jaccard similarity matrix to construct a statistically normalised synthetic code estimate. All matches are individually weighted by severity coefficient and contextual multiplier before summation, and the resulting headline score is temporally discounted to account for the repository's development history relative to the commercial emergence of large language model coding tooling (November 2022 onward).

37.4
Adjusted Score
37.4
Raw Score
100%
Time Factor
2026-07-04
Last Push
8.6K
Stars
Python
Language
5.6K
Lines of Code
41
Files
179
Pattern Hits
2026-07-14
Scan Date
0.00
HC Hit Rate

What These Metrics Mean

Adjusted Score
Primary synthetic code indicator. Raw score normalised per 1,000 lines of code and multiplied by the temporal discount factor. This is the definitive comparative metric — use it to rank repositories by AI authorship density.
Raw Score
The unmodified sum of all severity-weighted, context-multiplied pattern match scores before temporal discounting. Reflects the absolute signal strength independent of when the repository was last active.
Time Factor
The temporal discount multiplier (0–100%) applied to the raw score. Repositories last updated before ChatGPT's launch (Nov 2022) receive a 5% factor. Full signal is only assigned to repositories active in the post-adoption era (Jan 2024+).
Pattern Hits
Total count of individual pattern matches across all files and categories. A high hit count with a low score may indicate a very large codebase with isolated AI snippets; a low count with a high score indicates dense, concentrated AI signatures.
HC Hit Rate
High+Critical pattern hits per file, averaged across the repository. This orthogonal signal catches repositories where a few files are densely packed with high-severity AI tells — a strong indicator even when the normalised score appears moderate due to codebase size.
Lines of Code / Files
Total lines and files analysed. The scanner examines 94 file extensions. These denominators are used to normalise the score, enabling fair comparison between repositories of vastly different sizes.

Score History

This chart maps the temporal evolution of the adjusted synthetic code score across successive scan runs. An upward trajectory indicates ongoing incorporation of AI-generated code or expanding LLM-assisted scaffolding; a stable or declining trajectory may reflect active human refactoring, code removal, or the adoption of stricter authorship policies. The dashed secondary line (right axis) independently tracks total raw pattern hit count, which can diverge from the normalised score when codebase size changes significantly between scans.

Severity Breakdown

Classifies detected patterns by their diagnostic confidence and structural impact. CRITICAL patterns (coefficient 10) represent definitive synthetic signatures — hallucinated imports, explicit LLM attribution metadata — virtually never produced by human authors. HIGH (5) indicates strong structural tells such as cross-file repetition or cross-linguistic idioms. MEDIUM (2) covers recognisable conversational padding and AI-specific vocabulary. LOW (1) captures subtle indicators like tautological comments and generic boilerplate that require density to carry independent signal.

CRITICAL 0HIGH 0MEDIUM 23LOW 156

Directory Score Breakdown

This horizontal bar chart decomposes the repository's raw synthetic code score by top-level directory, allowing you to pinpoint precisely which modules or components carry the highest AI authorship density. Directories with disproportionately high scores relative to their size warrant targeted manual review: concentrated AI signatures often trace back to mass-generated configuration layers, auto-ported test suites, LLM-scaffolded boilerplate classes, or entire subsystems authored under heavy copilot assistance. Use this view to prioritise your human code-review effort.

Pattern Findings

The scanner identified 179 distinct pattern matches across 9 syntactic categories. Each entry below represents a discrete location in the source code where the engine recorded a statistically significant AI authorship indicator. Expand any category row to inspect the individual file paths, line numbers, code snippets, and the lexical context (CODE, COMMENT, or STRING) in which each match was detected.

Reading the findings table: The Severity column indicates the diagnostic confidence level (CRITICAL / HIGH / MEDIUM / LOW). The Context column identifies whether the match occurred inside executable code, an inline comment, or a string literal — comment-context matches receive a ×1.5 weight because LLMs systematically over-annotate. The ⚡ bolt icon marks clustered matches: three or more patterns within a 10-line window, each receiving an additional ×1.5 density multiplier as dense clusters constitute far stronger evidence of synthetic authorship than isolated hits.

Hyper-Verbose Identifiers108 hits · 77 pts
SeverityFileLineSnippetContext
LOWbook_to_skill/config.py37def supported_formats_message() -> str:CODE
LOWbook_to_skill/utils.py121def _structural_chapter_count(text: str) -> int:CODE
LOWbook_to_skill/parsers/docx.py8def extract_docx_with_python_docx(docx_path: str) -> str | None:CODE
LOWbook_to_skill/parsers/docx.py26def extract_docx_with_zipfile(docx_path: str) -> str | None:CODE
LOWbook_to_skill/parsers/calibre.py10def extract_with_ebook_convert(input_path: str) -> str | None:CODE
LOWtests/test_discovery_tax.py44 def test_detects_three_chapters(self):STRING
LOWtests/test_discovery_tax.py50 def test_best_chapter_picks_largest_body_over_toc_line(self):STRING
LOWtests/test_discovery_tax.py58 def test_cross_reference_does_not_split(self):STRING
LOWtests/test_discovery_tax.py64 def test_chapter_with_title_splits(self):STRING
LOWtests/test_discovery_tax.py69 def test_repeated_cross_ref_does_not_refragment(self):STRING
LOWtests/test_book_to_skill.py180 def test_epub_extract_with_ebooklib_returns_str_or_none(self):CODE
LOWtests/test_book_to_skill.py190 def test_epub_extraction_via_zipfile_fallback(self, tmp_path):CODE
LOWtests/test_book_to_skill.py225 def test_zipfile_fallback_resolves_oebps_paths(self, tmp_path):CODE
LOWtests/test_book_to_skill.py248 def test_container_xml_locates_opf(self, tmp_path):CODE
LOWtests/test_book_to_skill.py258 def test_count_chapters_with_oebps(self, tmp_path):CODE
LOWtests/test_book_to_skill.py266 def test_root_level_opf_still_works(self, tmp_path):CODE
LOWtests/test_book_to_skill.py284 def test_extract_single_file_raises_on_missing(self, tmp_path):CODE
LOWtests/test_book_to_skill.py290 def test_extract_single_file_raises_on_unsupported(self, tmp_path):CODE
LOWtests/test_book_to_skill.py296 def test_batch_continues_past_bad_files(self, tmp_path):CODE
LOWtests/test_book_to_skill.py368 def test_extraction_error_is_not_system_exit(self):CODE
LOWtests/test_book_to_skill.py382 def test_explicit_files_preserve_order(self, tmp_path):CODE
LOWtests/test_book_to_skill.py436 def test_deduplication_preserves_first_occurrence(self, tmp_path):CODE
LOWtests/test_book_to_skill.py451 def test_glob_filters_unsupported_extensions(self, tmp_path):CODE
LOWtests/test_book_to_skill.py578 def test_toc_spanish_accented(self):CODE
LOWtests/test_book_to_skill.py581 def test_toc_traditional_chinese(self):CODE
LOWtests/test_book_to_skill.py584 def test_toc_italian_sommario(self):CODE
LOWtests/test_book_to_skill.py587 def test_toc_inline_word_is_not_toc(self):CODE
LOWtests/test_book_to_skill.py592 def test_numbered_list_items_are_not_chapters(self):CODE
LOWtests/test_book_to_skill.py601 def test_inline_cross_references_are_not_chapters(self):CODE
LOWtests/test_book_to_skill.py608 def test_years_are_not_chapters(self):CODE
LOWtests/test_book_to_skill.py612 def test_real_headings_with_titles_count(self):CODE
LOWtests/test_book_to_skill.py620 def test_distinct_numbering_dedups_toc_and_body(self):CODE
LOWtests/test_book_to_skill.py625 def test_roman_numeral_chapters(self):CODE
LOWtests/test_book_to_skill.py629 def test_roman_requires_title_after_separator(self):CODE
LOWtests/test_book_to_skill.py633 def test_roman_rejects_non_canonical(self):CODE
LOWtests/test_book_to_skill.py637 def test_scans_full_text_not_just_head(self):CODE
LOWtests/test_book_to_skill.py648 def test_japanese_fullwidth_digit_chapters(self):CODE
LOWtests/test_book_to_skill.py654 def test_fullwidth_multi_digit_chapter(self):CODE
LOWtests/test_book_to_skill.py659 def test_chinese_di_n_jiang_lecture(self):CODE
LOWtests/test_book_to_skill.py664 def test_markdown_cjk_ordinal_heading(self):CODE
LOWtests/test_book_to_skill.py669 def test_markdown_di_n_jiang_heading(self):CODE
LOWtests/test_book_to_skill.py673 def test_chinese_dedups_toc_and_body(self):CODE
LOWtests/test_book_to_skill.py678 def test_cjk_detection_does_not_affect_latin(self):CODE
LOWtests/test_book_to_skill.py682 def test_markdown_atx_chapters(self):CODE
LOWtests/test_book_to_skill.py690 def test_asciidoc_section_headings(self):CODE
LOWtests/test_book_to_skill.py694 def test_asciidoc_deeper_levels(self):CODE
LOWtests/test_book_to_skill.py699 def test_markdown_prefixed_chapter_word(self):CODE
LOWtests/test_book_to_skill.py705 def test_headings_inside_code_fence_are_ignored(self):CODE
LOWtests/test_book_to_skill.py709 def test_plain_prose_has_no_structural_chapters(self):CODE
LOWtests/test_book_to_skill.py714 def test_numeric_chapters_win_over_markdown_subsections(self):CODE
LOWtests/test_book_to_skill.py720 def test_chinese_numeral_parsing(self):CODE
LOWtests/test_book_to_skill.py744 def test_german_kapitel_with_title(self):CODE
LOWtests/test_book_to_skill.py748 def test_european_lowercase_cross_reference_not_chapter(self):CODE
LOWtests/test_book_to_skill.py754 def test_german_kapitel_umlaut_title(self):CODE
LOWtests/test_book_to_skill.py759 def test_roman_heading_umlaut_title(self):CODE
LOWtests/test_book_to_skill.py764 def test_setext_rst_equals_three_sections(self):CODE
LOWtests/test_book_to_skill.py770 def test_setext_rst_dash_two_sections(self):CODE
LOWtests/test_book_to_skill.py778 def test_setext_equals_top_level_wins_over_dash(self):CODE
LOWtests/test_book_to_skill.py783 def test_setext_thematic_break_under_paragraph_not_heading(self):CODE
LOWtests/test_book_to_skill.py787 def test_setext_horizontal_rule_with_blank_above_not_heading(self):CODE
48 more matches not shown…
Decorative Section Separators19 hits · 69 pts
SeverityFileLineSnippetContext
MEDIUMtests/test_book_to_skill.py218# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py220# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py277# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py279# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py375# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py377# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py444# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py446# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py642 # ── Chinese (CJK) chapter headings ──────────────────────────────────────COMMENT
MEDIUMtests/test_book_to_skill.py969# ---------------------------------------------------------------------------COMMENT
MEDIUMtests/test_book_to_skill.py971# ---------------------------------------------------------------------------COMMENT
MEDIUMtests/test_book_to_skill.py20# ---------------------------------------------------------------------------COMMENT
MEDIUMtests/test_book_to_skill.py22# ---------------------------------------------------------------------------COMMENT
MEDIUMtests/test_book_to_skill.py43# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py45# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py495# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py497# ═══════════════════════════════════════════════════════════════════════════COMMENT
MEDIUMtests/test_book_to_skill.py173# ═══════════════════════════════════════════════════════════════════════════STRING
MEDIUMtests/test_book_to_skill.py175# ═══════════════════════════════════════════════════════════════════════════STRING
Excessive Try-Catch Wrapping22 hits · 23 pts
SeverityFileLineSnippetContext
LOWtools/discovery_tax.py54 except Exception:CODE
LOWtools/discovery_tax.py62 except Exception:CODE
MEDIUMtools/discovery_tax.py58def token_method() -> str:CODE
LOWbook_to_skill/utils.py554 except Exception:CODE
LOWbook_to_skill/dependencies.py94 except Exception as exc:CODE
LOWbook_to_skill/parsers/docx.py21 except Exception as e:CODE
LOWbook_to_skill/parsers/docx.py66 except Exception as e:CODE
LOWbook_to_skill/parsers/docx.py91 except Exception as e:CODE
LOWbook_to_skill/parsers/calibre.py24 except Exception as e:CODE
LOWbook_to_skill/parsers/pdf.py20 except Exception as e:CODE
LOWbook_to_skill/parsers/pdf.py34 except Exception:CODE
LOWbook_to_skill/parsers/pdf.py39 except Exception as e:CODE
LOWbook_to_skill/parsers/pdf.py50 except Exception as e:CODE
LOWbook_to_skill/parsers/pdf.py76 except Exception as e:CODE
LOWbook_to_skill/parsers/pdf.py92 except Exception:CODE
LOWbook_to_skill/parsers/pdf.py99 except Exception:CODE
LOWbook_to_skill/parsers/rtf.py44 except Exception as e:CODE
LOWbook_to_skill/parsers/text.py19 except Exception as e:CODE
LOWbook_to_skill/parsers/epub.py24 except Exception as e:CODE
LOWbook_to_skill/parsers/epub.py106 except Exception:CODE
LOWbook_to_skill/parsers/epub.py109 except Exception as e:CODE
LOWbook_to_skill/parsers/epub.py123 except Exception:CODE
Self-Referential Comments3 hits · 14 pts
SeverityFileLineSnippetContext
MEDIUMtests/test_book_to_skill.py298 # Create a valid text fileCOMMENT
MEDIUMtests/test_book_to_skill.py300 # Create a file that will fail (unsupported extension, garbage bytes)COMMENT
MEDIUMtests/test_book_to_skill.py869 # Create a malicious DOCXCOMMENT
Unused Imports13 hits · 13 pts
SeverityFileLineSnippetContext
LOWtools/discovery_tax.py31CODE
LOWbook_to_skill/__init__.py1CODE
LOWbook_to_skill/__init__.py1CODE
LOWbook_to_skill/__init__.py1CODE
LOWbook_to_skill/__init__.py2CODE
LOWbook_to_skill/utils.py1CODE
LOWbook_to_skill/dependencies.py1CODE
LOWbook_to_skill/parsers/docx.py1CODE
LOWbook_to_skill/parsers/calibre.py1CODE
LOWbook_to_skill/parsers/html.py1CODE
LOWbook_to_skill/parsers/pdf.py1CODE
LOWbook_to_skill/parsers/text.py1CODE
LOWbook_to_skill/parsers/epub.py1CODE
Deep Nesting11 hits · 11 pts
SeverityFileLineSnippetContext
LOWtools/validate_skill.py102CODE
LOWbook_to_skill/utils.py286CODE
LOWbook_to_skill/utils.py321CODE
LOWbook_to_skill/utils.py369CODE
LOWbook_to_skill/parsers/docx.py8CODE
LOWbook_to_skill/parsers/docx.py26CODE
LOWbook_to_skill/parsers/docx.py71CODE
LOWbook_to_skill/parsers/docx.py36CODE
LOWbook_to_skill/parsers/pdf.py25CODE
LOWbook_to_skill/parsers/pdf.py81CODE
LOWbook_to_skill/parsers/epub.py49CODE
Redundant / Tautological Comments1 hit · 2 pts
SeverityFileLineSnippetContext
LOWbook_to_skill/utils.py330 # Check if it has glob wildcardsCOMMENT
Modern Structural Boilerplate1 hit · 1 pts
SeverityFileLineSnippetContext
LOWbook_to_skill/__init__.py4__all__ = ["resolve_input_files", "extract_single_file", "main", "ExtractionError"]CODE
Over-Commented Block1 hit · 1 pts
SeverityFileLineSnippetContext
LOWbook_to_skill/utils.py61)COMMENT