跳到正文
cccskills
免费在 GitHub 公开

writing-style

Writing style guide for prose content - program descriptions, technique pages, blog posts, and any user-facing text. Use when writing or editing descriptive content.

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur星标 761(GitHub 761 + cccskills 0)

实测评分 未实测

查看安装方法

包含的文件(1)

  • SKILL.md8.7 KB

SKILL.md(原文)

安装前可以查看交给 AI 代理的指令内容。

Writing Style Guide

Apply these rules when writing any prose content for Liftosaur - program descriptions, technique pages, FAQ answers, whatsnew entries, blog posts, or any user-facing text.

Voice & Tone

Write like a knowledgeable training partner explaining something over coffee - conversational, honest, and encouraging. Not like an academic paper, a marketing brochure, or a corporate changelog.

Key traits of the Liftosaur voice:

  1. Personal and first-person. Use "I" for the developer's perspective. Use "you" when addressing the reader directly. This isn't a faceless product - it's built by a person who lifts.
  2. Encouraging without being patronizing. Normalize struggles and failure. "If you miss and chose a weight that is too heavy - that's okay! Record the weight and reps, and move on." Not "failure is an expected part of the training process."
  3. Honest about trade-offs. Acknowledge downsides and limitations directly. Don't sell - inform. "Sessions can take 90+ minutes" is better than omitting it.
  4. Transparent about decisions. Explain WHY choices were made, not just what was chosen. Frame features by the problem they solve: "A lot of users found it weird you can only adjust 1RM during a workout. So now there's a separate Exercises screen."

Plain Language

Use simple, common words. Prefer casual phrasing where it fits naturally.

  • "use" not "utilize" or "leverage"
  • "help" not "facilitate"
  • "best" not "optimal"
  • "enough" not "sufficient"
  • "about" not "approximately"
  • "start" not "initiate" or "commence"
  • "need" not "necessitate" or "require" (when "need" works)
  • "shows" not "demonstrates" or "illustrates"
  • "improves" not "enhances"
  • "works well for" not "is particularly well-suited for"
  • "way harder" not "significantly more difficult"
  • "pretty nice" not "quite satisfactory"

Don't go overboard - this isn't ELI5. Technical gym terms (periodization, progressive overload, AMRAP, RPE) are fine because the audience knows them. The goal is to avoid unnecessarily fancy phrasing where a simpler one says the same thing.

Bad (overwritten):

This methodology leverages undulating periodization to facilitate optimal neuromuscular adaptations across multiple training variables.

Bad (too dumbed down):

This program changes things up so your muscles keep growing.

Good (plain but precise):

The program uses undulating periodization - rep ranges change each session. Heavy one day, moderate the next, light after that. This keeps progress going longer than repeating the same sets and reps every workout.

Core Principles

  1. Be direct and specific. Lead with the answer, not the reasoning. "Add 5lb to bench press every successful session" - not "progressively increase the weight over time."
  2. Use concrete numbers. Sets, reps, percentages, pounds. Vague descriptions waste the reader's time.
  3. Don't pad. If a section has 2 bullet points of real content, that's fine. Don't stretch it to 5.
  4. Write for gym-literate readers. Assume they know sets, reps, 1RM, AMRAP. Don't explain basics. But don't assume they know the specific program or technique you're describing.

Sentence Rhythm

Vary sentence length deliberately. Same-length sentences are boring and hard to scan.

Mix short sentences (3-8 words) with longer ones that add detail. Use fragments where they feel natural. This makes text easier to skim - readers grab key points from short sentences and read longer ones when they want more.

Bad (monotonous):

This program uses linear progression for the main lifts. You will add weight to the bar each session. The rep scheme is based on 5 sets of 5 reps. You should rest 3-5 minutes between sets.

Good (varied rhythm):

Linear progression on the main lifts. Add 5lb to upper body and 10lb to lower body each session - simple and effective. Rest 3-5 minutes between heavy sets. The 5x5 scheme builds both strength and technique through volume at moderate intensity.

Conversational Patterns

Use these naturally - don't force them, but don't avoid them either:

  • Dashes for asides - parenthetical context that adds nuance without breaking flow
  • "Turns out" / "it turns out" for discovery language when revealing non-obvious facts
  • "So," at sentence starts to connect thoughts conversationally
  • "Pretty" as a softener - "pretty straightforward", "pretty hard to mess up"
  • "Way" as an intensifier - "way harder", "way more clear"
  • Short emphatic fragments - "That's it." "Simple and effective."
  • Questions as headers - "What the heck is RPE?" reads better than "RPE Explained"
  • Direct reassurance - "Don't be afraid to choose lighter weights" instead of "It is advisable to err on the side of caution with initial load selection"

Problem-Solution Framing

When describing features or changes, lead with the problem users had, then show the solution. This makes the reader immediately understand WHY something exists.

Bad:

Added a new Exercises screen with 1RM editing capabilities.

Good:

A lot of users found it weird you can only adjust 1RM during a workout. So now there's a separate Exercises screen where you can change it anytime.

Bad:

Implemented weight rounding visualization with strikethrough formatting.

Good:

It's confusing when the app rounds your weights to available plates - looks like a bug. So now it shows strikethrough on the original weight, making it clear what happened.

Specificity Over Vagueness

Bad:

  • "Well-balanced program"
  • "Can be complex"
  • "Good for hypertrophy"
  • "Progressively increase the weight over time"

Good:

  • "High frequency on main lifts (squat/bench 2x/week) builds technique fast"
  • "Sessions can take 90+ minutes due to 9 working sets of T1"
  • "Adds volume to isolation exercises without making sessions longer"
  • "Add 5lb each session you complete all reps"

Handling Complexity

When something sounds complicated, acknowledge it and then show it's manageable:

"It sounds pretty complicated, but should be way more clear when you look at the example below."

Concrete walkthrough examples beat abstract explanations. Show specific numbers:

"For instance, if you can do 5 reps (and no more) with 100 kg, then your 5 rep max is 100 kg. Let's say you guessed your 10RM for Bench Press is 185lb. So, you do: 5 reps with empty bar, 5 reps with 95lb, 3 reps with 135lb, 10 reps with 185lb."

Pros & Cons

When writing pros and cons, every item must be concrete and actionable.

  • State the specific advantage or disadvantage
  • Include numbers where relevant (session length, frequency, weight increments)
  • Explain WHY it's a pro or con, not just WHAT it is

Do NOT list "lack of exercise variety" as a con. Repeating the same exercises builds technique, enables progressive overload tracking, and is how every proven program works.

Explanations

When explaining WHY something is done, keep it to 1-2 sentences. Don't lecture. The reader wants the reason, not a textbook chapter.

FAQ Style

  • Questions should sound like real Google searches: "Is GZCLP good for beginners?" - not "Suitability for novice trainees"
  • Answers: 2-4 sentences, direct and specific
  • Don't repeat information word-for-word from the main description - rephrase and summarize
  • Include the program/technique name in at least 2-3 questions for SEO

Whatsnew / Changelog Style

  • Lead with what changed, not "We're excited to announce"
  • Frame features by the user problem they solve
  • Be honest when changes might break things: "This is a breaking change! If you use this feature, you likely would need to change your program"
  • Invite bug reports directly: "Could be bugs - don't hesitate to email me"
  • Thank contributors by name when applicable
  • Keep entries scannable with bullet points for multi-part updates

What to Avoid

  • Filler words and preamble ("We're excited to announce", "We're thrilled")
  • Restating what the reader already knows
  • Generic advice that applies to everything ("listen to your body", "consistency is key")
  • Overly academic or marketing tone
  • Corporate "we" - use "I" for the developer voice, or just describe the feature directly
  • Fancy words where simple ones work ("utilize" -> "use", "facilitate" -> "help")
  • Emojis (unless the user explicitly requests them)
  • Fancy Unicode characters - no emdashes, curly quotes, bullet dots, or other non-ASCII punctuation. Use plain ASCII: hyphens (-), straight quotes (""), asterisks (*) for lists, etc.
  • Double hyphens (--) for dashes - use a single hyphen (-) instead. "Linear progression on the main lifts - simple and effective" not "Linear progression on the main lifts -- simple and effective".

评价

还没有评价。欢迎分享你的使用感受。

评论

无需登录即可发表。欢迎分享使用感受、提问,或说明在哪些环境下无法运行。

还没有评论。来写第一条吧。

提交后会立即公开。请勿填写邮箱、电话等个人信息。URL 最多 2 个。

0 / 1000 字

此表单受 reCAPTCHA 保护,适用 Google 的隐私权政策和服务条款。

同一仓库的技能

Add a new built-in exercise to Liftosaur end-to-end — image (gymvisual.com → S3), catalog registration, description page, and the LLM/MCP exercise list. Use when adding one or more built-in exercises to the app catalog.

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur7612026年10月26日 更新

add-page

免费

Add a new server-rendered page to the Liftosaur website. Use when creating new public-facing pages with routing, SSR, and client hydration.

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur7612026年10月26日 更新

Create a 30%-off coupon for an affiliate or creator on iOS and Android, and draft the reply that tells them how to use it. Use when asked to create, set up or send a coupon or promo code for an affiliate, influencer or creator.

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur7612026年10月26日 更新

Interactively investigate a production Rollbar error. Accepts an occurrence id, item id, item counter, or Rollbar URL. Fetches the error data, assesses how widespread it is, drills into affected users (events, logs, storage, captured state), and works with the developer toward a fix or ignore decision. Use for collaborative debugging; use /fix-rollbar for a straight fetch-and-fix of a single occurrence.

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur7612026年10月26日 更新

Investigate a user-reported issue using server logs, user events, storage snapshots, and Rollbar. Use when given a user id or email plus an issue description (e.g. from a support email).

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur7612026年10月26日 更新

feature

免费

Build a feature end to end — decide worktree vs here, design the architecture and debate it with codex, get the user's approval on a one-pass-readable plan, state the API/state contract, implement with visible diffs, then run two codex reviews (bugs + architecture) and document the result. Use when asked to build/implement/add a feature or do a refactor that involves design decisions.

中文简介正在准备中。当前显示原文说明。

astashov/liftosaur7612026年10月26日 更新

查看 astashov 的全部技能

报告此技能的问题