frago-view-content-generate-tips-code

Code file content generation guide. Use this skill when you need to create code files that can be previewed via `frago view`. Covers supported languages, theme selection, and best practices.

$ Installer

git clone https://github.com/tsaijamey/frago /tmp/frago && cp -r /tmp/frago/src/frago/resources/skills/frago-view-content-generate-tips-code ~/.claude/skills/frago

// tip: Run this command in your terminal to install the skill


name: frago-view-content-generate-tips-code description: Code file content generation guide. Use this skill when you need to create code files that can be previewed via frago view. Covers supported languages, theme selection, and best practices.

Code File Content Generation Guide

Preview code files via frago view with automatic syntax highlighting.

Preview Commands

frago view script.py                      # Default theme
frago view script.py --theme monokai      # Specify theme

Supported File Types

ExtensionLanguagehighlight.js Tag
.pyPythonpython
.jsJavaScriptjavascript
.tsTypeScripttypescript
.jsxJSXjavascript
.tsxTSXtypescript
.cssCSScss
.scssSCSSscss
.htmlHTMLhtml
.jsonJSONjson
.yaml / .ymlYAMLyaml
.tomlTOMLtoml
.xmlXMLxml
.sqlSQLsql
.sh / .bashBashbash
.goGogo
.rsRustrust
.javaJavajava
.c / .hCc
.cpp / .hppC++cpp
.rbRubyruby
.phpPHPphp
.swiftSwiftswift
.ktKotlinkotlin
.luaLualua
.rRr
.txtPlain Textplaintext

Code Themes

ThemeStyleUse Case
github-darkGitHub Dark (default)Daily use
githubGitHub LightWhite background preference
monokaiMonokai ClassicDeveloper preference
atom-one-darkAtom DarkModern style
atom-one-lightAtom LightLight preference
vs2015Visual StudioWindows style
# Preview with different themes
frago view main.py --theme monokai
frago view config.yaml --theme atom-one-dark

Best Practices

1. File Encoding

  • Must use UTF-8 encoding
  • Avoid BOM header
  • Use LF line endings (Unix style)

2. Line Length

  • Single line no more than 120 characters
  • Very long lines will be truncated on display

3. Comment Guidelines

# Single-line comments should be clear and concise

"""
Multi-line comments used for:
- Module documentation
- Function documentation
- Complex logic explanation
"""

4. Code Structure

  • Group logic with blank line separation
  • Two blank lines between functions/classes
  • Group related imports

Display Features

Automatic Line Numbers

Code preview automatically displays line numbers for easy reference.

Syntax Highlighting

Based on highlight.js, automatically recognizes language and highlights:

  • Keywords
  • Strings
  • Comments
  • Numbers
  • Function names
  • Class names

Style Reference (github-dark)

ElementColor
Background#0d1117
Text#c9d1d9
Keywords#ff7b72
Strings#a5d6ff
Comments#8b949e
Functions#d2a8ff
Numbers#79c0ff

Notes

IssueCauseSolution
No syntax highlightingExtension not recognizedUse standard extensions
Chinese garbled textEncoding issueEnsure UTF-8
Truncated displayLine too longControl line length
Slow renderingFile too largeSplit or simplify

Use Cases

  • Code snippet display
  • Configuration file preview
  • Script review
  • Code sharing

Not suitable for: Complete source code of large projects (recommend using IDE)

Repository

tsaijamey
tsaijamey
Author
tsaijamey/frago/src/frago/resources/skills/frago-view-content-generate-tips-code
35
Stars
4
Forks
Updated6d ago
Added1w ago